Referenz der OLE DB-Consumervorlagen

Die OLE DB-Consumervorlagen enthalten die folgenden Klassen. Das Referenzmaterial enthält auch Themen zu Makros für OLE DB-Consumervorlagen.

Sitzungs-Klassen

• CDataConnection
  Verwaltet die Verbindung mit der Datenquelle. Dies ist eine nützliche Klasse zum Erstellen von Clients, da notwendige Objekte (Sitzung und Datenquelle) und zur Arbeit kapselt, die Sie, bei der Verbindung mit einer Datenquelle ausführen müssen.

• Ableiten
  Entspricht einem OLE DB-Datenquellenobjekt und stellt eine Verbindung durch einen Anbieter zu einer Datenquelle dar. Eine oder mehrere Datenbanksitzungen, jede, die durch ein CSession-Objekt dargestellt wird, können in einer einzelnen Verbindung stattfinden.

• CEnumerator
  Entspricht einem OLE DB-Enumeratorobjekt, das Rowsetinformationen über verfügbare Datenquellen abgerufen.

• CEnumeratorAccessor
  Wird von CEnumerator, um Daten vom Enumeratorrowset zuzugreifen. Dieses Rowset besteht Datenquellen und den Enumeratoren, die vom aktuellen Enumerator sichtbar sind.

• CSession
  Stellt eine einzelne Datenbankzugriffssitzung dar. Eine oder mehrere Sitzungen können mit jedem CDataSource-Objekt zugeordnet werden.

Accessorklassen

• CAccessor
  Wird für Datensätze, die statisch mit einer Datenquelle gebunden werden. Verwenden Sie diese Accessorklasse, wenn Ihnen die Struktur der Datenquelle kennen.

• CAccessorBase
  Basisklasse für alle Accessorklassen.

• CDynamicAccessor
  Ein Accessor, der zur Laufzeit erstellt werden, auf dem die Spalteninformationen des Rowsets. Verwenden Sie diese Klasse, um Daten abzurufen, wenn Ihnen die Struktur der Datenquelle kennen.

• CDynamicParameterAccessor
  Ein Accessor, der verwendet werden kann, wenn Befehlstypen unbekannt sind. Setzt die Parameterinformationen durch Aufrufen der ICommandWithParameters-Schnittstelle ein, wenn der Anbieter die Schnittstelle unterstützt.

• CDynamicStringAccessor
  Ermöglicht Ihnen, auf eine Datenquelle zuzugreifen, wenn Sie keine Kenntnisse der zugrunde liegende Struktur der Datenbank verfügen.

• CDynamicStringAccessorA
  Wie auch CDynamicStringAccessor allerdings zu dieser Klasse benötigt die Daten, die vom Datenspeicher als ANSI-Zeichenfolgendaten zugegriffen werden.

• CDynamicStringAccessorW
  Wie auch CDynamicStringAccessor allerdings zu dieser Klasse benötigt die Daten, die vom Datenspeicher als Unicode-Zeichenfolgen-Daten zugegriffen werden.

• CManualAccessor
  Ein Accessor mit Methoden, um Spalten und von Befehlsparametern zu behandeln. Mit dieser Klasse können Sie alle Datentypen verwenden, sofern der Anbieter konvertieren kann.

• CNoAccessor
  Kann als Vorlagenargument verwendet werden, wenn Sie die Klasse Parameter oder Ausgabespalten nicht unterstützen soll.

• CXMLAccessor
  Wie auch CDynamicStringAccessor allerdings zu dieser Klasse konvertiert alle Daten, die vom Datenspeicher als (markiert) zugegriffen werden Daten im XML-Format.

Rowset-Klassen

• CAccessorRowset
  Kapselt ein Rowset und seine zugeordneten Accessoren.

• CArrayRowset
  Wird verwendet, um auf Elemente eines Rowsets mithilfe von Arraysyntax zuzugreifen.

• CBulkRowset
  Wird verwendet, um Zeilen durch das Abrufen von mehrere Zeilenhandles mit einem einzelnen Aufruf in Massenauslagerungsvorgängen abzurufen und zu bearbeiten.

• CNoRowset
  Kann als Vorlagenargument verwendet werden, wenn der Befehl keinen Rowset zurückgibt.

• CRestrictions
  Wird verwendet, um Einschränkungen für Schemarowsets anzugeben.

• CRowset
  Wird verwendet, um Rowsetdaten bearbeiten, festzulegen und abzurufen.

• CStreamRowset
  Gibt ein ISequentialStream-Objekt statt eines Rowsets zurück; Sie verwenden dann die Lesen-Methode, um Daten in XML-Format abzurufen. (SQL Server 2000 führt die Formatierung; Beachten Sie, dass diese Funktion nur mit SQL Server 2000.)

• IRowsetNotifyImpl
  Enthält eine blinde Implementierung für IRowsetNotify, mit leeren Funktionen für die IRowsetNotify-Methoden OnFieldChange, OnRowChange und OnRowsetChange.

Schemarowset-Klassen und typedef-Klassen

Die OLE DB-Vorlagen bieten einen Satz von Klassen, die in OLE DB-Schemarowsets entsprechen.

Befehlsklassen

• CCommand
  Wird verwendet, um einen parameterbasierten OLE DB-Befehl festzulegen und auszuführen. Um lediglich ein einfaches Rowset zu öffnen, verwenden Sie stattdessen CTable.

• CMultipleResults
  Wird als Vorlagenargument für die CCommand - Vorlage, wenn Sie den Befehl möchten, mehrere Resultsets behandeln zu können.

• CNoAccessor
  Wird als Vorlagenargument für Vorlagenklassen, wie CCommand und CTable, die ein Accessorklassenargument nehmen. Verwenden Sie CNoAccessor, wenn die Klasse Parameter oder Ausgabespalten nicht unterstützen soll.

• CNoMultipleResults
  Wird als Vorlagenargument für die CCommand - Vorlage, wenn Sie den Befehl soll, ein einzelnes Rowset zu behandeln. CNoMultipleResults ist der Standardwert für das Vorlagenargument.

• CNoRowset
  Wird als Vorlagenargument für CCommand oder CTable, wenn der Befehl oder die Tabelle keinen Rowset zurückgibt.

• CTable
  Wird verwendet, um ein einfaches Rowset ohne Parameter zugreifen.

Eigenschaften-Klassen

• CDBPropIDSet
  Wird verwendet, um ein Array Eigenschaften-IDs übergeben, für die der Consumer Eigenschafteninformationen wünscht. Die Eigenschaften gehören einem Eigenschaft.

• CDBPropSet
  Wird verwendet, um Eigenschaften in einem Anbieter festzulegen.

Bookmark-Klasse

• CBookmark
  Wird als Index für den Zugriff auf Daten in einem Rowset.

Fehlertyps

• CDBErrorInfo
  Wird verwendet, um DB-Fehlerinformationen OLE abzurufen.

Siehe auch

Konzepte

Referenz der OLE DB-Anbietervorlagen

Weitere Ressourcen

OLE DB-Vorlagen