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 Verbinden ion strings and Data Links in the 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_sourceName-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	Nein
Erforderliche Attribute	None
Ungültige Attribute	None

Weitere Informationen zu den Attributkontexten finden Sie unter Attributkontexte.

Siehe auch

OLE DB-Consumerattribute