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