db_accessor
Atributos de db_column de grupos que participan en IAccessor- enlace basado.
[ db_accessor(
num,
auto
) ]
Parámetros
num
Especifica el número de descriptor de acceso (un índice entero único). Debe especificar números de descriptor de acceso en sentido petición, mediante enteros o valores definidos.Auto
Un valor booleano que especifica si se recuperan (TRUE) o no se recupera el descriptor automáticamente (FALSO).
Comentarios
db_accessor define el descriptor subyacente de OLE DB para db_column subsiguiente y los atributos de db_param dentro de la misma clase o de la función. db_accessor es utilizable en el nivel de miembro y se utiliza para agrupar los atributos de db_column que participan en OLE DB IAccessor- enlace basado. Se utiliza junto con los atributos de db_table o de db_command . Llamar a este atributo es similar a llamar a macros de BEGIN_ACCESSOR y de END_ACCESSOR .
db_accessor genera un conjunto de filas y enlazarlo a los mapas correspondientes de descriptor de acceso. Si no llama db_accessor, el descriptor de acceso 0 se generará automáticamente, y todos los enlaces de columna se asignan a este bloque de descriptor de acceso.
enlaces de columna de base de datos de los grupos dedb_accessor en uno o varios descriptores de acceso. Para obtener una descripción de las situaciones en las que es necesario utilizar múltiples descriptores de acceso, vea Utilizar varios descriptores de acceso en un conjunto de filas. Vea también “compatibilidad de registro para Múltiples Descriptores” en registros de usuario.
Cuando el proveedor de atributos de consumidor aplicar este atributo a una clase, el compilador cambiará la clase al _TheClassNameAccessor, donde es el nombre TheClassName que asignó la clase, y el compilador también creará una clase denominada TheClassName, que deriva de _TheClassNameAccessor. En la vista de clases, verá ambas clases.
Ejemplo
El ejemplo siguiente utiliza db_accessor para agrupar columnas de la tabla Orders de la base de datos Northwind en dos descriptores de acceso. El descriptor de acceso 0 es un descriptor de acceso automático, y el descriptor de acceso 1 no.
// 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;
};
Requisitos
Contexto de atributo
Se aplica a |
Bloques de atributo |
repetible |
No |
Atributos necesarios |
None |
Atributos no válidos |
None |
Para obtener más información sobre los contextos de atributos, vea Contextos de atributo.