db_table

  • Artikel

Öffnet eine OLE DB-Tabelle.

Syntax

[ db_table(db_table, name, source_name, hresult) ]

Parameter

db_table
Eine Zeichenfolge, die den Namen einer Datenbanktabelle angibt (z. B. "Produkte").

name
(Optional) Der Name des Handles, das Sie für die Arbeit mit der Tabelle verwenden. Sie müssen diesen Parameter angeben, wenn Sie mehrere Ergebniszeilen zurückgeben möchten. db_table generiert eine Variable mit dem angegebenen Namen, die verwendet werden kann, um das Rowset zu durchlaufen oder mehrere Aktionsabfragen auszuführen.

source_name
(Optional) Die CSession Variable oder Instanz einer Klasse, auf die das db_source Attribut angewendet wurde, auf das der Befehl ausgeführt wird. Informationen hierzu finden Sie unter db_source.

Hresult
(Optional) Gibt die Variable an, die das HRESULT dieses Datenbankbefehls empfängt. Wenn die Variable nicht existiert, wird sie automatisch durch das Attribut eingefügt.

Hinweise

db_table erstellt ein CTable-Objekt, das von einem OLE DB-Consumer zum Öffnen einer Tabelle verwendet wird. Sie können dieses Attribut nur auf Klassenebene verwenden; Sie können sie nicht inline verwenden. Dient zum Binden von Tabellenspalten an Variablen. Verwenden Sie db_column diese Option db_param zum Trennen (Festlegen des Parametertyps usw.) von Parametern.

Wenn der Consumer-Attributanbieter dieses Attribut auf eine Klasse anwendet, benennt der Compiler die Klasse in _YourClassNameAccessor um, wobei YourClassName der Name ist, den Sie der Klasse zugewiesen haben, und der Compiler erstellt auch eine Klasse namens "YourClassName", die von _YourClassName Accessor abgeleitet wird. In dieser Klassenansicht werden beide Klassen angezeigt.

Beispiel

Im folgenden Beispiel wird die Tabelle "Products" zur Verwendung durch CProductsgeöffnet.

// db_table.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>

[ db_table(L"dbo.Products") ]
class CProducts {
   [ db_column("1") ] LONG m_ProductID;
};

Ein Beispiel für dieses Attribut, das in einer Anwendung verwendet wird, finden Sie unter MultiRead.

Anforderungen

Attributkontext Wert
Gilt für class, struct
Wiederholbar Nein
Erforderliche Attribute None
Ungültige Attribute None

Weitere Informationen zu den Attributkontexten finden Sie unter Attributkontexte.

Siehe auch

OLE DB-Consumerattribute