db_table

  • Artykuł

Otwiera tabelę OLE DB.

Składnia

[ db_table(db_table, name, source_name, hresult) ]

Parametry

db_table
Ciąg określający nazwę tabeli bazy danych (na przykład "Products").

name
(Opcjonalnie) Nazwa uchwytu używanego do pracy z tabelą. Należy określić ten parametr, jeśli chcesz zwrócić więcej niż jeden wiersz wyników. db_table generuje zmienną o określonej nazwie, która może służyć do przechodzenia przez zestaw wierszy lub wykonywania wielu zapytań akcji.

Source_name
(Opcjonalnie) Zmienna CSession lub wystąpienie klasy, która ma db_source zastosowany atrybut, na którym jest wykonywane polecenie. Zobacz db_source.

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_table tworzy obiekt CTable, który jest używany przez konsumenta OLE DB do otwierania tabeli. Tego atrybutu można używać tylko na poziomie klasy; nie można jej użyć w tekście. Użyj db_column polecenia , aby powiązać kolumny tabeli ze zmiennymi; użyj polecenia db_param , aby rozdzielić (ustawić typ parametru itd.) parametrów.

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.

Przykład

W poniższym przykładzie zostanie otwarta tabela Products do użycia przez CProductsprogram .

// db_table.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>

[ db_table(L"dbo.Products") ]
class CProducts {
   [ db_column("1") ] LONG m_ProductID;
};

Aby zapoznać się z przykładem tego atrybutu używanego w aplikacji, zobacz MultiRead.

Wymagania

Kontekst atrybutu Wartość
Dotyczy class, struct
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