db_accessor
Atrybuty grup db_column
, które uczestniczą w IAccessor
powiązaniu opartym na .
Składnia
[ db_accessor(num, auto) ]
Parametry
Num
Określa numer dostępu (indeks liczby całkowitej opartej na zerze). Należy określić numery metod dostępu w kolejności rosnącej, używając liczb całkowitych lub zdefiniowanych wartości.
auto
Wartość logiczna określająca, czy akcesorium jest automatycznie pobierane (TRUE), czy nie pobrane (FALSE).
Uwagi
db_accessor definiuje podstawowe metody dostępu OLE DB dla kolejnych db_column
atrybutów i db_param
w ramach tej samej klasy lub funkcji. db_accessor jest używany na poziomie elementu członkowskiego i służy do grupowania db_column
atrybutów uczestniczących w powiązaniu opartym na OLE DBIAccessor
. Jest on używany w połączeniu db_table
z atrybutami lub db_command
. Wywoływanie tego atrybutu jest podobne do wywoływania makr BEGIN_ACCESSOR i END_ACCESSOR .
db_accessor generuje zestaw wierszy i wiąże go z odpowiednimi mapami dostępu. Jeśli nie wywołasz db_accessor, metoda dostępu 0 zostanie wygenerowana automatycznie, a wszystkie powiązania kolumn zostaną zamapowane na ten blok dostępu.
db_accessor grupuje powiązania kolumn bazy danych w jeden lub więcej metod dostępu. Aby zapoznać się z omówieniem scenariuszy, w których należy użyć wielu metod dostępu, zobacz Korzystanie z wielu metod dostępu w zestawie wierszy. Zobacz również artykuł "Obsługa rekordów użytkownika dla wielu metod dostępu" w temacie Rekordy użytkownika.
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 użyto db_accessor do grupowania kolumn w tabeli Orders z bazy danych Northwind w dwie metody dostępu. Akcesorium 0 jest automatycznym akcesorem, a akcesorium 1 nie jest.
// cpp_attr_ref_db_accessor.cpp
// compile with: /LD /link /OPT:NOREF
#define _ATL_ATTRIBUTES
#include <atlbase.h>
#include <atldbcli.h>
[ db_command(L"SELECT LastName, FirstName FROM Orders") ]
class CEmployees {
public:
[ db_accessor(0, TRUE) ];
[ db_column("1") ] LONG m_OrderID;
[ db_column("2") ] TCHAR m_CustomerID[6];
[ db_column("4") ] DBTIMESTAMP m_OrderDate;
[ db_accessor(1, FALSE) ];
[ db_column("8") ] CURRENCY m_Freight;
};
Wymagania
Kontekst atrybutu | Wartość |
---|---|
Dotyczy | Bloki atrybutów |
Powtarzalne | Nie. |
Wymagane atrybuty | Brak |
Nieprawidłowe atrybuty | Brak |
Aby uzyskać więcej informacji na temat kontekstów atrybutów, zobacz Konteksty atrybutów.