Riferimenti ai modelli consumer OLE DB
I modelli consumer OLE DB contengono le classi seguenti. Il materiale di riferimento include anche argomenti sulle macro per i modelli di consumer OLE DB.
Classi di sessione
CDataConnection
Gestisce la connessione con l'origine dati. Si tratta di una classe utile per la creazione di client perché incapsula gli oggetti necessari (origine dati e sessione) e alcune delle operazioni da eseguire per la connessione a un'origine dati.
CDataSource
Corrisponde a un oggetto origine dati OLE DB, che rappresenta una connessione tramite un provider a un'origine dati. Una o più sessioni di database, ognuna rappresentata da un CSession
oggetto, può essere eseguita su una singola connessione.
CEnumerator
Corrisponde a un oggetto enumeratore OLE DB, che recupera informazioni sul set di righe sulle origini dati disponibili.
CEnumeratorAccessor
Utilizzato da CEnumerator
per accedere ai dati dal set di righe dell'enumeratore. Questo set di righe è costituito dalle origini dati e dagli enumeratori visibili dall'enumeratore corrente.
CSession
Rappresenta una singola sessione di accesso al database. Una o più sessioni possono essere associate a ogni CDataSource
oggetto.
Classi di funzioni di accesso
CAccessor
Utilizzato per i record associati staticamente a un'origine dati. Usare questa classe della funzione di accesso quando si conosce la struttura dell'origine dati.
CAccessorBase
Classe base per tutte le classi di funzioni di accesso.
CDynamicAccessor
Funzione di accesso che può essere creata in fase di esecuzione, in base alle informazioni sulla colonna del set di righe. Usare questa classe per recuperare i dati se non si conosce la struttura dell'origine dati.
CDynamicParameterAccessor
Funzione di accesso che può essere usata quando i tipi di comando sono sconosciuti. Ottiene le informazioni sui parametri chiamando l'interfaccia ICommandWithParameters
, se il provider supporta l'interfaccia .
CDynamicStringAccessor
Consente di accedere a un'origine dati quando non si ha alcuna conoscenza della struttura sottostante del database.
CDynamicStringAccessorA
Analogamente al fatto CDynamicStringAccessor
che questa classe richiede l'accesso ai dati dall'archivio dati come dati stringa ANSI.
CDynamicStringAccessorW
Analogamente al fatto CDynamicStringAccessor
che questa classe richiede l'accesso ai dati dall'archivio dati come dati stringa UNICODE.
CManualAccessor
Funzione di accesso con metodi per gestire sia colonne che parametri di comando. Con questa classe è possibile usare qualsiasi tipo di dati, purché il provider possa convertire il tipo.
CNoAccessor
Può essere usato come argomento modello quando non si vuole che la classe supporti parametri o colonne di output.
CXMLAccessor
Analogamente al CDynamicStringAccessor
fatto che questa classe converte tutti i dati a cui si accede dall'archivio dati come dati in formato XML (con tag).
Classi del set di righe
CAccessorRowset
Incapsula un set di righe e le relative funzioni di accesso associate.
CArrayRowset
Utilizzato per accedere agli elementi di un set di righe usando la sintassi della matrice.
CBulkRowset
Consente di recuperare e modificare le righe in blocco recuperando più handle di riga con una singola chiamata.
CNoRowset
Può essere usato come argomento modello se il comando non restituisce un set di righe.
CRestrictions
Consente di specificare restrizioni per i set di righe dello schema.
CRowset
Utilizzato per modificare, impostare e recuperare i dati del set di righe.
CStreamRowset
Restituisce un ISequentialStream
oggetto anziché un set di righe, quindi utilizzare il Read
metodo per recuperare i dati in formato XML. SQL Server 2000 esegue la formattazione. Si noti che questa funzionalità funziona solo con SQL Server 2000.
IRowsetNotifyImpl
Fornisce un'implementazione fittizia per IRowsetNotify
, con funzioni vuote per i IRowsetNotify
metodi OnFieldChange
, OnRowChange
e OnRowsetChange
.
Classi Rowset dello schema e classi Typedef
I modelli OLE DB forniscono un set di classi che corrispondono ai set di righe dello schema OLE DB.
Classi di comandi
CCommand
Utilizzato per impostare ed eseguire un comando OLE DB basato su parametri. Per aprire semplicemente un semplice set di righe, usare CTable
invece .
CMultipleResults
Usato come argomento modello per il CCommand
modello quando si desidera che il comando gestisca più set di risultati.
CNoAccessor
Usato come argomento modello per le classi modello, ad esempio CCommand
e CTable
, che accettano un argomento della classe della funzione di accesso. Usare CNoAccessor
se non si vuole che la classe supporti parametri o colonne di output.
CNoMultipleResults
Usato come argomento modello per il CCommand
modello quando si desidera che il comando gestisca un singolo set di righe. CNoMultipleResults
è il valore predefinito per l'argomento modello.
CNoRowset
Utilizzato come argomento modello per CCommand
o CTable
se il comando o la tabella non restituisce un set di righe.
CTable
Consente di accedere a un semplice set di righe senza parametri.
Classi di proprietà
CDBPropIDSet
Consente di passare una matrice di ID proprietà per cui il consumer desidera informazioni sulle proprietà. Le proprietà appartengono a un set di proprietà.
CDBPropSet
Utilizzato per impostare le proprietà in un provider.
Classe Bookmark
CBookmark
Utilizzato come indice per l'accesso ai dati in un set di righe.
Classe Error
CDBErrorInfo
Utilizzato per recuperare le informazioni sull'errore OLE DB.