db_source
Tworzy połączenie ze źródłem danych.
Składnia
[ db_source(db_source, name, hresult) ]
Parametry
db_source
Parametry połączenia używane do nawiązywania połączenia ze źródłem danych. Aby zapoznać się z formatem parametry połączenia, zobacz Parametry połączenia i linki danych w zestawie SDK składników dostępu do danych (MDAC) firmy Microsoft.
name
(Opcjonalnie) Jeśli używasz db_source w klasie, nazwa jest wystąpieniem obiektu źródła danych, który ma zastosowany atrybut db_source (zobacz przykład 1). Jeśli używasz db_source wbudowanej w implementacji metody, nazwa to zmienna (lokalna dla metody), która może służyć do uzyskiwania dostępu do źródła danych (patrz przykład 2). Tę nazwę należy przekazać do parametru source_name, db_command aby skojarzyć źródło danych z poleceniem .
hresult
(Opcjonalnie) Identyfikuje zmienną, która otrzyma hrESULT tego polecenia bazy danych. Jeśli zmienna nie istnieje, zostanie ona automatycznie wstrzyknięta przez atrybut .
Uwagi
db_source tworzy obiekt CDataSource i CSession, który razem reprezentuje połączenie ze źródłem danych użytkownika OLE DB.
Gdy używasz db_source w klasie, CSession obiekt staje się elementem członkowskim klasy.
W przypadku użycia db_source w metodzie wstrzyknięty kod zostanie wykonany w zakresie metody, a CSession obiekt zostanie utworzony jako zmienna lokalna.
db_source dodaje właściwości źródła danych do klasy lub metody. Jest on używany w połączeniu z db_command (który przyjmuje parametr nazwy db_source jako parametr source_name).
Gdy dostawca atrybutów konsumenta zastosuje ten atrybut do klasy, kompilator zmieni nazwę klasy na _YourClassName Accessor, gdzie YourClassName jest nazwą nadaną klasę, a kompilator utworzy również klasę o nazwie YourClassName, która pochodzi z _YourClassName Accessor. W widoku klasy zobaczysz obie klasy.
Aby zapoznać się z przykładem tego atrybutu używanego w aplikacji, zobacz MultiRead.
Przykład
Ten przykład wywołuje db_source w klasie, aby utworzyć połączenie ze źródłem ds danych przy użyciu bazy danych Northwind. ds to dojście dla źródła danych, które może być używane wewnętrznie do CMyCommand klasy.
// 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 {};
Wymagania
| Kontekst atrybutu | Wartość |
|---|---|
| Dotyczy | class, structelement członkowski, metoda, lokalna |
| Powtarzalne | Nie. |
| Wymagane atrybuty | Brak |
| Nieprawidłowe atrybuty | Brak |
Aby uzyskać więcej informacji na temat kontekstów atrybutów, zobacz Konteksty atrybutów.