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_source name 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 obrigatórios | Nenhum |
| Atributos inválidos | Nenhum |
Para obter mais informações sobre os contextos de atributo, confira Contextos de atributo.