db_source
Vytvoří připojení ke zdroji dat.
[ db_source(
db_source,
name,
hresult
) ]
Parametry
db_source
Spojovací řetězec použitý k připojení ke zdroji dat.Formát řetězce připojení, viz řetězce připojení a propojení dat v Microsoft Data Access Components (MDAC) sady SDK.název (volitelné)
Při použití db_source na třídě, název je instance objekt zdroje dat, který má db_source atribut použit (viz Příklad 1).Při použití db_source vložených do implementace metody název je proměnná (místní metody) lze použít k přístupu k datům zdroje (viz Příklad 2).Toto předání název se source_name parametr db_command příkazu přiřadit zdroje dat.hresult (volitelné)
Identifikuje proměnnou, která bude přijímat HRESULT tohoto příkazu databáze.Pokud proměnná neexistuje, jej budou automaticky vkládány atributem.
Poznámky
db_sourcevytvoří CDataSource a CSession objektu, které dohromady představují připojení ke zdroji dat OLE DB spotřebitele.
Při použití db_source na třídě, CSession objekt se stane členem třídy.
Při použití db_source v metodě, vloženého kódu bude spuštěn v rámci metody oboru a CSession objektu je vytvořena jako místní proměnné.
db_sourcePřidá vlastnosti zdroje dat nebo v rámci metody třídy.Se používá ve spojení s db_command (které trvá db_sourcenázev jako parametr jeho source_name parametr).
Pokud zprostředkovatel spotřebitele atribut použije tento atribut třídy, kompilátor bude přejmenovat třídu _YourClassNamepřístupový objekt, kde YourClassName je název třídy a kompilátor vytvoří také třídy nazvané YourClassName, který je odvozen z _YourClassNamepřístupový objekt.Třída zobrazení se zobrazí obě třídy.
Příklad tohoto atributu v aplikaci naleznete vzorky AtlAgent a MultiRead.
Příklad
Tento vzorek volá db_source na třídě vytvořit připojení ke zdroji dat ds pomocí databáze Northwind.dsPopisovač zdroje dat, které lze použít k interně je CMyCommand třídy.
// 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
Atribut kontextu
V aplikacích |
Třída, struct, člen, metoda, místní |
Opakovatelné |
Ne |
Požadované atributy |
Žádná |
Neplatné atributy |
Žádná |
Další informace o kontextech atribut, viz Kontexty atribut.