db_table
Öffnet eine OLE DB-Tabelle.
[ db_table(
db_table,
name,
source_name,
hresult
) ]
Parameter
db_table
Eine Zeichenfolge, die den Namen einer Datenbanktabelle angibt (z. B. „Products“).Name (optional)
Der Name des Handles, das Sie verwenden, um mit der Tabelle zu bearbeiten. Sie müssen diesen Parameter angeben, wenn Sie mehr als eine Zeile der Ergebnisse zurückgeben möchten. db_table generiert eine Variable mit dem angegebenen Namen, der verwendet werden kann, um das Rowset zu durchlaufen oder Abfragen mehrerer Aktion auszuführen.source_name (optional)
Die CSession-Variable oder eine Instanz einer Klasse, die das db_source darauf angewendeten Attribut enthält, auf dem der Befehl ausgeführt wird, oder legt diesen fest. Weitere Informationen finden Sie unter db_source.hresult (optional)
Identifiziert die Variable, die HRESULT dieses Befehls Datenbank erhält. Wenn die Variable nicht vorhanden ist, wird sie automatisch vom Attribut eingefügt.
Hinweise
db_table erstellt ein CTable-Objekt, das durch einen OLE DB-Consumer verwendet wird, um eine Tabelle zu öffnen. Dieses Attribut kann nur auf Klassenebene verwenden. Sie können sie nicht inline verwenden. Verwenden Sie db_column , um Tabellenspalten zu den Variablen gebunden werden soll. (Verwenden Sie db_param festgelegt usw.) entnehmen dem Parametertyp getrennt.
Wenn der Consumer Attribut für Textanbieter dieses Attribut auf eine Klasse angewendet wird, benennt der Compiler die Klasse zum _TheClassNameAccessor, in dem TheClassName der Name ist, den Sie für die Klasse haben, und der Compiler außerdem eine Klasse erstellt, die TheClassName aufgerufen wird , die vom _TheClassNameAccessor berechnet. In der Klassenansicht finden Sie unter beide Klassen.
Beispiel
Im folgenden Beispiel wird die Tabelle Products für CProducts.
// 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 in den Beispielen AtlAgent und MultiRead.
Anforderungen
Attribut-Kontext
Betrifft |
Klasse, struct |
Wiederholbar |
Nein |
Erforderliche Attribute |
None |
Ungültige Attribute |
None |
Weitere Informationen über das kontexte finden Sie unter Attribut-Kontexte.