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ů.

Viz také

Atributy příjemce technologie OLE DB