db_table
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 | Brak |
| Nieprawidłowe atrybuty | Brak |
Aby uzyskać więcej informacji na temat kontekstów atrybutów, zobacz Konteksty atrybutów.