db_table
Abre una tabla OLE DB.
Sintaxis
[ db_table(db_table, name, source_name, hresult) ]
Parámetros
db_table
Cadena que especifica el nombre de una tabla de base de datos (como "Productos").
name
(Opcional) Nombre del identificador usado para trabajar con la tabla. Debe especificar este parámetro si desea devolver más de una fila de resultados. db_table genera una varialbe con el nombre especificado que se puede usar para recorrer el conjunto de filas o ejecutar varias consultas de acción.
source_name
(Opcional) Variable o instancia CSession de una clase que tiene aplicado el atributo db_source, en el que se ejecuta el comando. Consulte db_source.
hresult
(Opcional) Identifica la variable que recibirá el HRESULT de este comando de base de datos. Si la variable no existe, el atributo la insertará automáticamente.
Comentarios
db_table crea un objeto CTable, que un consumidor OLE DB usa para abrir una tabla. Puede usar este atributo solo en el nivel de clase; no se puede usar alineado. Use db_column para enlazar columnas de tabla con variables; use db_param para delimitar (establecer el tipo de parámetro, etc.) de los parámetros.
Cuando el proveedor de atributos de consumidor aplica este atributo a una clase, el compilador cambiará el nombre de la clase a _NombreClaseDescriptorAcceso, donde NombreClase es el nombre asignado a la clase; el compilador también creará una clase denominada NombreClase, que deriva de _NombreClaseDescriptorAcceso. En Vista de clases verá ambas clases.
Ejemplo
En el ejemplo siguiente se abre la tabla Products para que la use CProducts.
// 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;
};
Para obtener un ejemplo de este atributo usado en una aplicación, consulte MultiRead.
Requisitos
| Contexto de atributo | Valor |
|---|---|
| Se aplica a | class, struct |
| Reiterativo | No |
| Atributos requeridos | Ninguno |
| Atributos no válidos | Ninguno |
Para obtener más información acerca de los contextos de atributo, consulte Contextos de atributo.