db_source
Vytvoří připojení ke zdroji dat.
Syntaxe
[ db_source(db_source, name, hresult) ]
Parametry
db_source
Připojovací řetězec sloužící k připojení ke zdroji dat. Formát připojovací řetězec naleznete v tématu Připojovací řetězce a datové odkazy v sadě MICROSOFT Data Access Components (MDAC) SDK.
Jméno
(Volitelné) Pokud používáte db_source ve třídě, název je instance objektu zdroje dat, který má použitý atribut db_source (viz příklad 1). Pokud použijete db_source vloženou v implementaci metody, název je proměnná (místní pro metodu), která se dá použít pro přístup ke zdroji dat (viz příklad 2). Tento název předáte parametru db_command source_name přidružení zdroje dat k příkazu.
hresult
(Volitelné) Identifikuje proměnnou, která obdrží HRESULT tohoto databázového příkazu. Pokud proměnná neexistuje, automaticky se vloží atributem.
Poznámky
db_source vytvoří CDataSource a objekt CSession, který společně představuje připojení ke zdroji dat příjemce OLE DB.
Když použijete db_source třídy, CSession objekt se stane členem třídy.
Při použití db_source v metodě se vložený kód spustí v rámci oboru metody a CSession objekt se vytvoří jako místní proměnná.
db_source přidá vlastnosti zdroje dat do třídy nebo v rámci metody. Používá se ve spojení s parametrem db_command db_source name (který přebírá parametr source_name).
Když zprostředkovatel atributu příjemce použije tento atribut na třídu, kompilátor přejmenuje třídu na _YourClassNameAccessor, kde YourClassName je název, který jste dali třídě, a kompilátor vytvoří také třídu s názvem YourClassName, která je odvozena z _YourClassNameAccessor. V zobrazení třídy uvidíte obě třídy.
Příklad tohoto atributu použitého v aplikaci naleznete v tématu MultiRead.
Příklad
Tato ukázka volá db_source třídy k vytvoření připojení ke zdroji ds dat pomocí databáze Northwind. ds je popisovač pro zdroj dat, který lze interně použít pro CMyCommand třídu.
// 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 {};
Požadavky
| Kontext atributu | Hodnota |
|---|---|
| Platí pro | class, , structčlen, metoda, místní |
| Opakovatelný | No |
| Požadované atributy | Nic |
| Neplatné atributy | Nic |
Další informace o kontextech atributů naleznete v tématu Kontexty atributů.