db_source
Crea una conexión con un origen de datos.
Sintaxis
[ db_source(db_source, name, hresult) ]
Parámetros
db_source
Cadena de conexión utilizada para conectar con el origen de datos. Para obtener el formato de la cadena de conexión, consulte Cadenas de conexión y vínculos de datos en el SDK de Microsoft Data Access Components (MDAC).
name
(Opcional) Cuando se usa db_source en una clase, name es una instancia de un objeto de origen de datos que tiene aplicado el atributo db_source (consulte el ejemplo 1). Cuando se usa el atributo db_source insertado en una implementación de método, name es una variable (local con respecto al método) que se puede usar para acceder al origen de datos (consulte el ejemplo 2). Este nombre se pasa al parámetro source_name de db_command para asociar el origen de datos a un comando.
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_source crea un objeto CDataSource y otro CSession, que representan una conexión con un origen de datos de consumidor OLE DB.
Cuando se usa db_source en una clase, el objeto CSession se convierte en miembro de la clase.
Cuando se usa db_source en un método, el código insertado se ejecutará dentro del ámbito del método y el objeto CSession se crea como una variable local.
db_source agrega propiedades de origen de datos a una clase o dentro de un método. Se usa junto con db_command (que toma el parámetro name de db_source como parámetro source_name).
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.
Para obtener un ejemplo de este atributo usado en una aplicación, consulte MultiRead.
Ejemplo
En este ejemplo se llama a db_source en una clase para crear una conexión al origen de datos ds mediante la base de datos Northwind. ds es un identificador del origen de datos que se puede usar internamente en la clase CMyCommand.
// db_source_1.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>
[
db_source(L"my_connection_string", name="ds"),
db_command(L"select * from Products")
]
class CMyCommand {};
Requisitos
| Contexto de atributo | Valor |
|---|---|
| Se aplica a | class, struct, miembro, método, local |
| 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.