db_source
Erstellt eine Verbindung mit einer Datenquelle.
Syntax
[ db_source(db_source, name, hresult) ]
Parameter
db_source
Die Verbindungszeichenfolge zum Herstellen einer Verbindung mit der Datenquelle verwendet. Das Format der Verbindungszeichenfolge finden Sie unter "Verbindungszeichenfolgen und Datenlinks" im Microsoft Data Access Components (MDAC)-SDK.
name
(Optional) Wenn Sie db_source für eine Klasse verwenden, ist der Name eine Instanz eines Datenquellenobjekts, auf das das db_source Attribut angewendet wurde (siehe Beispiel 1). Wenn Sie db_source inline in einer Methodenimplementierung verwenden, ist der Name eine Variable (lokal für die Methode), die für den Zugriff auf die Datenquelle verwendet werden kann (siehe Beispiel 2). Sie übergeben diesen Namen an den source_name Parameter, mit db_command dem die Datenquelle einem Befehl zugeordnet werden soll.
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_source erstellt ein CDataSource- und ein CSession-Objekt, das zusammen eine Verbindung mit einer OLE DB-Consumerdatenquelle darstellt.
Wenn Sie db_source für eine Klasse verwenden, wird das CSession Objekt zu einem Element der Klasse.
Wenn Sie db_source in einer Methode verwenden, wird der eingefügte Code innerhalb des Methodenbereichs ausgeführt, und das CSession Objekt wird als lokale Variable erstellt.
db_source fügt einer Klasse oder innerhalb einer Methode Datenquelleneigenschaften hinzu. Sie wird in Verbindung mit db_command (der den db_source Name-Parameter als source_name Parameter verwendet).
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.
Ein Beispiel für dieses Attribut, das in einer Anwendung verwendet wird, finden Sie unter MultiRead.
Beispiel
In diesem Beispiel wird db_source für eine Klasse aufgerufen, um eine Verbindung mit der Datenquelle ds mithilfe der Northwind-Datenbank zu erstellen. ds ist ein Handle für die Datenquelle, die intern für die CMyCommand Klasse verwendet werden kann.
// db_source_1.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>
[
db_source(L"my_connection_string", name="ds"),
db_command(L"select * from Products")
]
class CMyCommand {};
Anforderungen
| Attributkontext | Wert |
|---|---|
| Gilt für | class, structMember, Methode, lokal |
| Wiederholbar | No |
| Erforderliche Attribute | Keine |
| Ungültige Attribute | Keine |
Weitere Informationen zu den Attributkontexten finden Sie unter Attributkontexte.