db_source

Cria uma conexão com uma fonte de dados.

Sintaxe

[ db_source(db_source, name, hresult) ]

Parâmetros

db_source
A cadeia de conexão usada para conectar à fonte de dados. Para o formato da cadeia de conexão, confira Cadeias de conexão e links de dados no SDK do MDAC (Microsoft Data Access Components).

name
(Opcional) Quando você usa db_source em uma classe, o name é uma instância de um objeto de fonte de dados que tem o atributo db_source aplicado a ele (confira o exemplo 1). Quando você usa db_source embutido em uma implementação de método, name é uma variável (local para o método) que pode ser usada para acessar a fonte de dados (veja o exemplo 2). Você passa esse name para o parâmetro source_name de db_command para associar a fonte de dados a um comando.

hresult
(Opcional) Identifica a variável que receberá o HRESULT desse comando de banco de dados. Se a variável não existir, ela será injetada automaticamente pelo atributo.

Comentários

db_source cria um objeto CDataSource e objeto CSession, que, juntos, representam uma conexão com uma fonte de dados do consumidor OLE DB.

Quando você usa db_source em uma classe, o objeto CSession se torna um membro da classe.

Quando você usa db_source em um método, o código injetado é executado no escopo do método e o objeto CSession é criado como uma variável local.

db_source adiciona propriedades de fonte de dados a uma classe ou dentro de um método. Ele é usado em conjunto com db_command (que usa o parâmetro db_sourcename como seu parâmetro source_name).

Quando o provedor de atributos de consumidor aplica esse atributo a uma classe, o compilador renomeia a classe como _YourClassNameAccessor, em que YourClassName é o nome que você deu à classe, e o compilador também criará uma classe chamada YourClassName, que deriva de _YourClassNameAccessor. No Modo de Exibição de Classe, você verá ambas as classes.

Para obter um exemplo desse atributo usado em um aplicativo, consulte MultiRead.

Exemplo

Este exemplo chama db_source em uma classe para criar uma conexão com a fonte de dados ds usando o banco de dados Northwind. ds é um identificador para a fonte de dados, que pode ser usada internamente para a classe 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 do atributo	Valor
Aplicável ao	class, struct, membro, método, local
Repetível	Não
Atributos necessários	Nenhum
Atributos inválidos	Nenhum

Para obter mais informações sobre os contextos de atributo, confira Contextos de atributo.

Confira também

Atributos de consumidor do OLE DB