db_accessor
Raggruppa db_column gli attributi che partecipano all'associazione IAccessorbasata su .
Sintassi
[ db_accessor(num, auto) ]
Parametri
num
Specifica il numero della funzione di accesso (indice integer in base zero). È necessario specificare i numeri delle funzioni di accesso in ordine crescente, usando numeri interi o valori definiti.
auto
Valore booleano che specifica se la funzione di accesso viene recuperata automaticamente (TRUE) o non recuperata (FALSE).
Osservazioni:
db_accessor definisce la funzione di accesso OLE DB sottostante per gli attributi e db_param successivi db_column all'interno della stessa classe o funzione. db_accessor è utilizzabile a livello di membro e viene usato per raggruppare db_column gli attributi che partecipano all'associazione basata su OLE DBIAccessor. Viene usato insieme agli db_table attributi o db_command . La chiamata a questo attributo è simile alla chiamata delle macro BEGIN_ACCESSOR e END_ACCESSOR .
db_accessor genera un set di righe e lo associa alle mappe delle funzioni di accesso corrispondenti. Se non si chiama db_accessor, la funzione di accesso 0 verrà generata automaticamente e tutte le associazioni di colonna verranno mappate a questo blocco di funzioni di accesso.
db_accessor raggruppa le associazioni di colonne di database in una o più funzioni di accesso. Per una descrizione degli scenari in cui è necessario usare più funzioni di accesso, vedere Uso di più funzioni di accesso in un set di righe. Vedere anche "Supporto dei record utente per più funzioni di accesso" nei record utente.
Quando il provider di attributi consumer applica questo attributo a una classe, il compilatore rinomina la classe in _YourClassNameFunzione di accesso, dove YourClassName è il nome assegnato alla classe e il compilatore creerà anche una classe denominata YourClassName, che deriva dalla funzione di accesso _YourClassName. In Visualizzazione classi verranno visualizzate entrambe le classi.
Esempio
L'esempio seguente usa db_accessor per raggruppare le colonne della tabella Orders dal database Northwind in due funzioni di accesso. La funzione di accesso 0 è una funzione di accesso automatica e la funzione di accesso 1 non è .
// 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;
};
Requisiti
| Contesto attributo | Valore |
|---|---|
| Si applica a | Blocchi di attributi |
| Ripetibile | No |
| Attributi obbligatori | None |
| Attributi non validi | None |
Per altre informazioni sui contesti di attributi, vedere Contesti di attributi.