db_accessor

Atrybuty grup db_column , które uczestniczą w IAccessorpowią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	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