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 Połączenie ion Strings and Data Links (Linki do danych) w zestawie SDK składników dostępu do danych firmy Microsoft (MDAC).

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_sourcejako 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	None
Nieprawidłowe atrybuty	None

Aby uzyskać więcej informacji na temat kontekstów atrybutów, zobacz Konteksty atrybutów.

Zobacz też

Atrybuty konsumentów OLE DB