Il Modello ad Oggetti di ADO - Properties e Property

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

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.

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.

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

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'.

I commenti sono aggiunti quando e soprattutto se ho il tempo di guardarli e dopo aver eliminato le cagate, spam, tentativi di phishing et similia. Quindi non trattenete il respiro.

Nessun messaggio this document does not accept new posts

Precedente Successivo

Davide Bianchi, lavora come Unix/Linux System Administrator presso una societa' di Hosting in Olanda.

Volete contribuire? Leggete come!.

Il presente sito e' frutto del sudore della mia fronte (e delle mie dita), se siete interessati a ripubblicare uno degli articoli, documenti o qualunque altra cosa presente in questo sito per cortesia datemene comunicazione (o all'autore dell'articolo se non sono io), cosi' il giorno che faccio delle aggiunte potro' avvisarvi e magari mandarvi il testo aggiornato.