Référence des modèles du consommateur OLE DB
Les modèles de consommateur OLE DB contiennent les classes suivantes. Le matériel de référence inclut également des rubriques sur les macros pour les modèles de consommateur OLE DB.
Session Classes
CDataConnection
Gère la connexion avec la source de données. Il s’agit d’une classe utile pour la création de clients, car elle encapsule les objets nécessaires (source de données et session) et certaines tâches que vous devez effectuer lors de la connexion à une source de données.
CDataSource
Correspond à un objet de source de données OLE DB, représentant une connexion via un fournisseur à une source de données. Une ou plusieurs sessions de base de données, chacune représentée par un CSession objet, peuvent se produire sur une seule connexion.
CEnumerator
Correspond à un objet d’énumérateur OLE DB, qui récupère des informations d’ensemble de lignes sur les sources de données disponibles.
CEnumeratorAccessor
Utilisé pour CEnumerator accéder aux données à partir de l’ensemble de lignes d’énumérateur. Cet ensemble de lignes se compose des sources de données et des énumérateurs visibles à partir de l’énumérateur actuel.
CSession
Représente une session d’accès à une base de données unique. Une ou plusieurs sessions peuvent être associées à chaque CDataSource objet.
Classes d’accesseur
CAccessor
Utilisé pour les enregistrements liés statiquement à une source de données. Utilisez cette classe d’accesseur lorsque vous connaissez la structure de la source de données.
CAccessorBase
Classe de base pour toutes les classes d’accesseur.
CDynamicAccessor
Accesseur qui peut être créé au moment de l’exécution, en fonction des informations de colonne de l’ensemble de lignes. Utilisez cette classe pour récupérer des données si vous ne connaissez pas la structure de la source de données.
CDynamicParameterAccessor
Accesseur qui peut être utilisé lorsque les types de commandes sont inconnus. Obtient les informations de paramètre en appelant l’interface ICommandWithParameters , si le fournisseur prend en charge l’interface.
CDynamicStringAccessor
Vous permet d’accéder à une source de données lorsque vous n’avez aucune connaissance de la structure sous-jacente de la base de données.
CDynamicStringAccessorA
Similaire à ce CDynamicStringAccessor que cette classe demande des données accessibles à partir du magasin de données en tant que données de chaîne ANSI.
CDynamicStringAccessorW
Similaire à ce CDynamicStringAccessor que cette classe demande des données accessibles à partir du magasin de données en tant que données de chaîne UNICODE.
CManualAccessor
Accesseur avec des méthodes pour gérer les colonnes et les paramètres de commande. Avec cette classe, vous pouvez utiliser n’importe quel type de données tant que le fournisseur peut convertir le type.
CNoAccessor
Peut être utilisé comme argument de modèle lorsque vous ne souhaitez pas que la classe prend en charge les paramètres ou les colonnes de sortie.
CXMLAccessor
Similaire à ce CDynamicStringAccessor que cette classe convertit toutes les données accessibles à partir du magasin de données en tant que données au format XML (étiquetées).
Classes d’ensemble de lignes
CAccessorRowset
Encapsule un ensemble de lignes et ses accesseurs associés.
CArrayRowset
Permet d’accéder aux éléments d’un ensemble de lignes à l’aide de la syntaxe de tableau.
CBulkRowset
Permet d’extraire et de manipuler des lignes en bloc en récupérant plusieurs handles de ligne avec un seul appel.
CNoRowset
Peut être utilisé comme argument de modèle si la commande ne retourne pas d’ensemble de lignes.
CRestrictions
Permet de spécifier des restrictions pour les ensembles de lignes de schéma.
CRowset
Utilisé pour manipuler, définir et récupérer des données d’ensemble de lignes.
CStreamRowset
Retourne un objet plutôt qu’un ISequentialStream ensemble de lignes ; vous utilisez ensuite la Read méthode pour récupérer des données au format XML. (SQL Server 2000 effectue la mise en forme ; notez que cette fonctionnalité fonctionne uniquement avec SQL Server 2000.)
IRowsetNotifyImpl
Fournit une implémentation factice pour IRowsetNotify, avec des fonctions vides pour les IRowsetNotify méthodes OnFieldChange, OnRowChangeet OnRowsetChange.
Classes de jeu de lignes du schéma et classes Typedef
Les modèles OLE DB vous fournissent un ensemble de classes qui correspondent aux ensembles de lignes de schéma OLE DB.
Classes de commandes
CCommand
Permet de définir et d’exécuter une commande OLE DB basée sur des paramètres. Pour simplement ouvrir un ensemble de lignes simple, utilisez CTable plutôt.
CMultipleResults
Utilisé comme argument de modèle pour le CCommand modèle lorsque vous souhaitez que la commande gère plusieurs jeux de résultats.
CNoAccessor
Utilisé comme argument de modèle pour les classes de modèle, telles que CCommand et CTable, qui prennent un argument de classe d’accesseur. Utilisez CNoAccessor si vous ne souhaitez pas que la classe prend en charge les paramètres ou les colonnes de sortie.
CNoMultipleResults
Utilisé comme argument de modèle pour le CCommand modèle lorsque vous souhaitez que la commande gère un ensemble de lignes unique. CNoMultipleResults est la valeur par défaut de l’argument de modèle.
CNoRowset
Utilisé comme argument de modèle pour CCommand ou CTable si la commande ou la table ne retourne pas d’ensemble de lignes.
CTable
Permet d’accéder à un ensemble de lignes simple sans paramètres.
Classes de propriétés
CDBPropIDSet
Utilisé pour passer un tableau d’ID de propriété pour lequel le consommateur souhaite obtenir des informations sur les propriétés. Les propriétés appartiennent à un jeu de propriétés.
CDBPropSet
Permet de définir des propriétés sur un fournisseur.
Bookmark, classe
CBookmark
Utilisé comme index pour accéder aux données dans un ensemble de lignes.
Classe d’erreur
CDBErrorInfo
Utilisé pour récupérer les informations d’erreur OLE DB.