db_table
Ö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 | No |
| Erforderliche Attribute | Keine |
| Ungültige Attribute | Keine |
Weitere Informationen zu den Attributkontexten finden Sie unter Attributkontexte.