db_source
Tworzy połączenie ze źródłem danych.
[ db_source(
db_source,
name,
hresult
) ]
Parametry
db_source
Ciąg połączenia używany do łączenia się ze źródłem danych.Format ciągu połączenia, zobacz ciągów połączenia i powiązania danych w programie Microsoft Data Access Components (MDAC) SDK.Nazwa (opcjonalnie)
Podczas używania db_source w klasie, Nazwa jest wystąpieniem obiektu źródła danych, który ma db_source atrybut stosowane do niego (patrz: przykład 1).Podczas używania db_source wbudowanej w implementacji metody, Nazwa jest zmienna (lokalny do metody), używany do uzyskania dostępu do danych źródła (zob. przykład 2).Przekazuje się to Nazwa do source_name parametr db_command do kojarzenia źródła danych przy użyciu polecenia.hresult(opcjonalnie)
Określa zmienną, która będzie odbierać HRESULT tego polecenia do bazy danych.Jeśli zmienna nie istnieje, to zostaną automatycznie dodane przez atrybut.
Uwagi
db_sourceTworzy CDataSource i CSession obiektu, które razem stanowią połączenie ze źródłem danych OLE DB konsumenta.
Kiedy używać db_source w klasie, CSession obiekt staje się członkiem tej klasy.
Kiedy używać db_source w metodzie, kod zostanie wykonana w obrębie zakresu metody i CSession tworzony jest obiekt jako zmienna lokalna.
db_sourcedodaje właściwości źródła danych, do klasy lub wewnątrz metody.Jest używana w połączeniu z db_command (który bierze db_sourceNazwa parametr jako jej source_name parametr).
Gdy dostawca atrybut konsumenta stosuje się ten atrybut do klasy, kompilator będzie Zmień nazwę klasy do _YourClassNameakcesor, gdzie YourClassName jest nazwą nadaną klasy i kompilator utworzy również klasy o nazwie YourClassName, który pochodzi od _YourClassNameakcesor.W widoku klasy widać obu klas.
Przykładem tego atrybutu, wykorzystaną w aplikacji, zobacz próbki AtlAgent i MultiRead.
Przykład
Próbka ta wywołuje db_source w klasie, aby utworzyć połączenie ze źródłem danych ds przy użyciu bazy danych Northwind.dsto dojście do źródła danych, które mogą 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
Atrybutu kontekstu
Stosuje się do |
Klasa, struct, członka, metody, lokalne |
Powtarzalne |
Nr |
Wymagane atrybuty |
Brak |
Nieprawidłowe atrybuty |
Brak |
Aby uzyskać więcej informacji na temat kontekstów atrybutu, zobacz Kontekstów atrybutu.