ADO's Object Model - Properties e Property


Home Page | Comments | Articles | Faq | Documents | Search | Archive | Tales from the Machine Room | Contribute | Set language to:en it | Login/Register


A cura di Davide Bianchi ADO e' l'interfaccia piu' usata per accedere ai database sotto Windows, non solo mediante ASP, ma anche mediante Visual Basic, C/C++ ed altri ambienti di sviluppo.

La collection Properties

Proprieta'
Count

Metodi
Item, Refresh

L'insieme Properties contiene tutti gli oggetti Property relativi a uno specifico oggetto. Ciascun oggetto Property corrisponde a una caratteristica dell'oggetto specifico del provider.

Per esempio, la proprieta' ConnectionTimeout dell'oggetto Connection, fornisce informazioni relative al numero di secondi da attendere prima di stabilire che una Connection non puo' essere ottenuta. La proprieta' Updatability per il Recordset informa se lo stesso puo' essere aggiornato o meno.

L'esempio seguente reperisce informazioni relative alla Connection.


Dim Cn As New ADODB.Connection
Dim Cmd As New ADODB.Command
Dim rs As New ADODB.Recordset
    
Cn.Open "pubs", "sa"
' Find out ConnectionTimeout property.
Debug.Print Cn.Properties("Connect Timeout")
    
Set Cmd.ActiveConnection = Cn
Cmd.CommandText = "titles"
Cmd.CommandType = adCmdTable
Set rs = Cmd.Execute()
    
' find out CommandTimeout property.
Debug.Print Cmd.Properties("Command Time out")
    
Debug.Print rs.Properties("Updatability")
Torna alla mappa

Proprieta'

Count Indica il numero di oggetti contenuti nell'insieme. E' una proprieta' di sola lettura. Se il valore restituito e' pari a 0, l'insieme e' vuoto e non contiene nessun oggetto.

Nota:
La numerazione degli oggetti nell'insieme parte da 0 e non da 1.

Metodi

Item Restituisce un membro specifico dell'insieme in base al nome o al numero ordinale.

Sintassi


prop = oggetto.Properties.Item( indice )
prop e' la variabile Property che ricevera' l'oggetto richiesto.
oggetto e' l'oggetto di cui si stanno ispezionando le Property.
indice e' il nome o il numero ordinale dell'oggetto da reperire.

Osservazioni
Utilizzare Item per reperire un oggetto specifico nell'insieme. Se non e' possibile trovare nell'insieme un oggetto corrispondente all'argomento indice, si verifichera' un errore.

Item e' il metodo predefinito per tutti gli insiemi, quindi e' possibile utilizzare anche la forma "ridotta" del metodo.


prop = oggetto.Properties( indice )
Refresh Aggiorna gli oggetti dell'insieme in modo che corrispondano agli oggetti specifici disponibili presso il provider.

Sintassi


oggetto.Properties.Refresh
oggetto e' l'oggetto di cui si stanno leggendo le Property. Osservazioni
Utilizzando Refresh su alcuni oggetti si inseriscono nell'insieme le proprieta' dinamiche che il provider espone. Tali proprieta' forniscono informazioni sulle funzionalita' specifiche del provider oltre alle proprieta' incorporate supportate da ADO.

L'oggetto Property

Proprieta'
Attributes, Name, Type, Value

Metodi
L'oggetto Property non ha metodi.

Ogni oggetto Property ha un valore, un tipo e degli "attributi", questi forniscono informazioni aggiuntive, per esempio se la proprieta' in questione e' supportata o no dall'oggetto stesso, e puo' essere scritta etc.

Torna alla mappa

Proprieta'

Attributes Osservazioni
Questa proprieta' e' di sola lettura e il suo valore puo' corrispondere alla somma di uno o piu' dei valori della tabella che segue.
  • adPropNotSupported
    Indica che la proprieta' non e' supportata dal provider.
  • adPropRequired
    Indica che l'utente deve specificare un valore per la proprieta' prima dell'inizializzazione della fonte dati.
  • adPropOptional
    Indica che non e' necessario specificare un valore per la proprieta' prima dell'inizializzazione della fonte dati.
  • adPropRead
    Indica che l'utente puo' leggere la proprieta'.
  • adPropWrite
    Indica che l'utente puo' impostare la proprieta'.

Name Indica il nome della proprieta'.

Type Indica il tipo operativo o il tipo di dato dell'oggetto, questa proprieta' e' di sola lettura.

Il valore puo' essere una delle costanti seguenti: L'indicatore di tipo OLE DB corrispondente e' riportato tra parentesi. Per ulteriori informazioni sui tipi di dati OLE DB, consultare il capitolo 10 e l'appendice A della guida di riferimento per i programmatori di OLE DB.

  • adArray
    Unito in un operatore logico OR a un altro tipo per indicare che i dati costituiscono una matrice sicura di quel tipo (DBTYPE_ARRAY).
  • adBigInt
    Intero con segno da 8 byte (DBTYPE_I8).
  • adBinary
    Valore binario (DBTYPE_BYTES).
  • adBoolean
    Valore booleano (DBTYPE_BOOL).
  • adByRef
    Unito in un operatore logico OR a un altro tipo per indicare che i dati costituiscono un puntatore a dati di altro tipo (DBTYPE_BYREF).
  • adBSTR
    Stringa di caratteri a terminazione Null (Unicode) (DBTYPE_BSTR).
  • adChar
    Valore String (DBTYPE_STR).
  • adCurrency
    Valore di valuta (DBTYPE_CY). Si tratta di un numero a virgola fissa con quattro cifre a destra della virgola decimale. E' memorizzato in un intero con segno da 8 byte scalato per 10.000.
  • adDate
    Valore Date (DBTYPE_DATE). Si tratta di una data memorizzata come Double, la cui parte intera rappresenta il numero di giorni a partire dal 30 dicembre 1899, mentre la parte frazionaria rappresenta la frazione di un giorno.
  • adDBDate
    Valore data (ggmmaaaa) (DBTYPE_DBDATE).
  • adDBTime
    Valore tempo (oommss) (DBTYPE_DBTIME).
  • adDBTimeStamp
    Indicatore data/ora (ggmmaaaaoommss piu' una frazione in miliardesimi) (DBTYPE_DBTIMESTAMP).
  • adDecimal
    Valore numerico esatto con grado di precisione e di scala fisso (DBTYPE_DECIMAL).
  • adDouble
    Valore con virgola mobile in precisione doppia (DBTYPE_R8).
  • adEmpty
    Non e' stato specificato alcun valore (DBTYPE_EMPTY).
  • adError
    Codice di errore a 32 bit (DBTYPE_ERROR).
  • adGUID
    Identificatore univoco globale (GUID) (DBTYPE_GUID).
  • adIDispatch
    Puntatore a un'interfaccia Idispatch su un oggetto OLE (DBTYPE_IDISPATCH).
  • adInteger
    Intero con segno da 4 byte (DBTYPE_I4).
  • adIUnknown
    Puntatore a un'interfaccia Iunknown su un oggetto OLE (DBTYPE_IUNKNOWN).
  • adLongVarBinary
    Valore binario lungo (solo oggetto Parameter).
  • adLongVarChar
    Valore String lungo (solo oggetto Parameter).
  • adLongVarWChar
    Valore stringa a terminazione Null lungo (solo oggetto Parameter).
  • adNumeric
    Valore numerico esatto con grado di precisione e di scala fisso (DBTYPE_NUMERIC).
  • adSingle
    Valore con virgola mobile in precisione semplice (DBTYPE_R4).
  • adSmallInt
    Intero con segno da 2 byte (DBTYPE_I2).
  • adTinyInt
    Intero con segno da 1 byte (DBTYPE_I1).
  • adUnsignedBigInt
    Intero senza segno da 8 byte (DBTYPE_UI8).
  • adUnsignedInt
    Intero senza segno da 4 byte (DBTYPE_UI4).
  • adUnsignedSmallInt
    Intero senza segno da 2 byte (DBTYPE_UI2).
  • adUnsignedTinyInt
    Intero senza segno da 1 byte (DBTYPE_UI1).
  • adUserDefined
    Variabile definita dall'utente (DBTYPE_UDT).
  • adVarBinary
    Valore binario (solo oggetto Parameter).
  • adVarChar
    Valore String (solo oggetto Parameter).
  • adVariant
    Variant di automazione (DBTYPE_VARIANT).
  • adVector
    Unito in un operatore logico OR a un altro tipo per indicare che i dati rappresentano una struttura DBVECTOR, cosi' come viene definita da OLE DB, nella quale sono inclusi il conteggio degli elementi e un puntatore a dati di altro tipo (DBTYPE_VECTOR).
  • adVarWChar
    Stringa di caratteri Unicode a terminazione Null (solo oggetto Parameter).
  • adWChar
    Stringa di caratteri Unicode a terminazione Null (DBTYPE_WSTR).

Value Contiene il valore della proprieta'.

Comments are added when and more important if I have the time to review them and after removing Spam, Crap, Phishing and the like. So don't hold your breath. And if your comment doesn't appear, is probably becuase it wasn't worth it.

No messages  this document does not accept new posts

Previous Next


Davide Bianchi, works as Unix/Linux administrator for an hosting provider in The Netherlands.

Do you want to contribute? read how.  
 


This site is made by me with blood, sweat and gunpowder, if you want to republish or redistribute any part of it, please drop me (or the author of the article if is not me) a mail.


This site was composed with VIM, now is composed with VIM and the (in)famous CMS FdT.

This site isn't optimized for vision with any specific browser, nor it requires special fonts or resolution.
You're free to see it as you wish.

Web Interoperability Pleadge Support This Project Powered By Gigan