Referenz der OLE DB-Consumervorlagen
Die OLE DB Consumer Templates enthalten die folgenden Klassen. Das Referenzmaterial enthält auch Themen zu den Makros für OLE DB Consumer Templates.
Sitzungsklassen
CDataConnection
Verwaltet die Verbindung mit der Datenquelle. Dies ist eine nützliche Klasse zum Erstellen von Clients, da sie die erforderlichen Objekte (Datenquelle und Sitzung) und einige der Erforderlichen beim Herstellen einer Verbindung mit einer Datenquelle kapselt.
CDataSource
Entspricht einem OLE DB-Datenquellenobjekt, das eine Verbindung über einen Anbieter zu einer Datenquelle darstellt. Eine oder mehrere Datenbanksitzungen, die jeweils durch ein CSession Objekt dargestellt werden, können in einer einzigen Verbindung ausgeführt werden.
CEnumerator
Entspricht einem OLE DB-Enumerationsobjekt, das Rowsetinformationen zu verfügbaren Datenquellen abruft.
CEnumeratorAccessor
Wird vom CEnumerator Enumerator-Rowset verwendet, um auf die Daten zuzugreifen. Dieses Rowset besteht aus den Datenquellen und Enumerationen, die vom aktuellen Enumerationsgeber angezeigt werden.
CSession
Stellt eine einzelne Datenbankzugriffssitzung dar. Mindestens eine Sitzung kann jedem CDataSource Objekt zugeordnet werden.
Accessorklassen
CAccessor
Wird für Datensätze verwendet, die statisch an eine Datenquelle gebunden sind. Verwenden Sie diese Accessorklasse, wenn Sie die Struktur der Datenquelle kennen.
CAccessorBase
Basisklasse für alle Accessorklassen.
CDynamicAccessor
Ein Accessor, der zur Laufzeit erstellt werden kann, basierend auf den Spalteninformationen des Rowsets. Verwenden Sie diese Klasse, um Daten abzurufen, wenn Sie die Struktur der Datenquelle nicht kennen.
CDynamicParameterAccessor
Ein Accessor, der verwendet werden kann, wenn Befehlstypen unbekannt sind. Ruft die Parameterinformationen durch Aufrufen der ICommandWithParameters Schnittstelle ab, wenn der Anbieter die Schnittstelle unterstützt.
CDynamicStringAccessor
Ermöglicht ihnen den Zugriff auf eine Datenquelle, wenn Sie keine Kenntnisse über die zugrunde liegende Struktur der Datenbank haben.
CDynamicStringAccessorA
Ähnlich wie CDynamicStringAccessor bei dieser Klasse werden Daten angefordert, auf die über den Datenspeicher als ANSI-Zeichenfolgendaten zugegriffen wird.
CDynamicStringAccessorW
Ähnlich wie CDynamicStringAccessor diese Klasse daten vom Datenspeicher als UNICODE-Zeichenfolgendaten anfordert.
CManualAccessor
Ein Accessor mit Methoden zum Behandeln von Spalten und Befehlsparametern. Mit dieser Klasse können Sie alle Datentypen verwenden, solange der Anbieter den Typ konvertieren kann.
CNoAccessor
Kann als Vorlagenargument verwendet werden, wenn Sie nicht möchten, dass die Klasse Parameter oder Ausgabespalten unterstützt.
CXMLAccessor
Ähnlich wie CDynamicStringAccessor bei dieser Klasse werden alle Daten, auf die aus dem Datenspeicher zugegriffen wird, als XML-formatierte (markierte) Daten konvertiert.
Rowset-Klassen
CAccessorRowset
Kapselt ein Rowset und die zugehörigen Accessoren.
CArrayRowset
Wird für den Zugriff auf Elemente eines Rowsets mithilfe der Arraysyntax verwendet.
CBulkRowset
Wird verwendet, um Zeilen in Massen abzurufen und zu bearbeiten, indem mehrere Zeilenhandles mit einem einzelnen Aufruf abgerufen werden.
CNoRowset
Kann als Vorlagenargument verwendet werden, wenn der Befehl kein Rowset zurückgibt.
CRestrictions
Wird verwendet, um Einschränkungen für Schema-Rowsets anzugeben.
CRowset
Wird zum Bearbeiten, Festlegen und Abrufen von Rowsetdaten verwendet.
CStreamRowset
Gibt ein ISequentialStream Objekt anstelle eines Rowsets zurück. Anschließend verwenden Sie die Read Methode, um Daten im XML-Format abzurufen. (SQL Server 2000 führt die Formatierung aus. Beachten Sie, dass dieses Feature nur mit SQL Server 2000 funktioniert.)
IRowsetNotifyImpl
Stellt eine Dummyimplementierung für IRowsetNotify, mit leeren Funktionen für die IRowsetNotify Methoden OnFieldChange, OnRowChangeund OnRowsetChange.
Schemarowset-Klassen und Typedef-Klassen
Die OLE DB-Vorlagen bieten Ihnen eine Reihe von Klassen, die den OLE DB-Schema-Rowsets entsprechen.
Befehlsklassen
CCommand
Wird verwendet, um einen parameterbasierten OLE DB-Befehl festzulegen und auszuführen. Verwenden Sie CTable stattdessen, um ein einfaches Rowset zu öffnen.
CMultipleResults
Wird als Vorlagenargument für die CCommand Vorlage verwendet, wenn der Befehl mehrere Resultsets behandeln soll.
CNoAccessor
Wird als Vorlagenargument für Vorlagenklassen verwendet, z CCommand . B. und CTable, die ein Accessorklassenargument verwenden. Verwenden Sie diese Methode CNoAccessor , wenn die Klasse Parameter oder Ausgabespalten nicht unterstützt.
CNoMultipleResults
Wird als Vorlagenargument für die CCommand Vorlage verwendet, wenn der Befehl ein einzelnes Rowset behandeln soll. CNoMultipleResults ist der Standardwert für das Vorlagenargument.
CNoRowset
Wird als Vorlagenargument für CCommand oder CTable wenn der Befehl oder die Tabelle kein Rowset zurückgibt.
CTable
Wird für den Zugriff auf ein einfaches Rowset ohne Parameter verwendet.
Eigenschaftsklassen
CDBPropIDSet
Wird verwendet, um ein Array von Eigenschafts-IDs zu übergeben, für das der Verbraucher Eigenschaftsinformationen wünscht. Die Eigenschaften gehören zu einem Eigenschaftensatz.
CDBPropSet
Wird verwendet, um Eigenschaften für einen Anbieter festzulegen.
Bookmark-Klasse
CBookmark
Wird als Index für den Zugriff auf Daten in einem Rowset verwendet.
Fehlerklasse
CDBErrorInfo
Wird zum Abrufen von OLE DB-Fehlerinformationen verwendet.