db_source
Crea una connessione a un'origine dati.
[ db_source(
db_source,
name,
hresult
) ]
Parametri
db_source
La stringa di connessione utilizzata per connettere l'origine dati. Per il formato della stringa di connessione, vedere Stringhe di connessione e collegamenti ai dati in Microsoft Data Access Components (MDAC) SDK.nome (facoltativo)
Quando si utilizzano db_source in una classe, nome è un'istanza di un oggetto origine dati che ha db_source attributo applicato a (vedere l'esempio 1). Quando si utilizzano db_source inline in un'implementazione di metodo, nome è una variabile locale (il metodo) che può essere utilizzata per accedere all'origine dati (vedere l'esempio 2). Passare questo nome in source_name parametro di db_command per associare l'origine dati a un comando.hresult (facoltativo)
identifica la variabile che riceverà HRESULT di questo comando di database. Se la variabile non esiste, verrà automaticamente inserita dall'attributo.
Note
db_source crea un oggetto CDataSource e CSession oggetto, che rappresentano insieme una connessione a un'origine dati consumer OLE DB.
Quando si utilizzano db_source in una classe, CSession l'oggetto diventa un membro della classe.
Quando si utilizzano db_source in un metodo, il codice inserito verrà eseguito entro l'ambito dei metodi e CSession l'oggetto viene creato come variabile locale.
db_source aggiunge le proprietà dell'origine dati a una classe o all'interno di un metodo. Viene utilizzata insieme con db_command (che accetta db_source nome parametro come proprio source_name parametro).
Quando il provider di tipo consumer di attributo applicato questo attributo a una classe, il compilatore la classe a _TheClassNamefunzione di accesso, dove TheClassName è il nome assegnato alla classe e il compilatore inoltre creata una classe denominata TheClassName, quale deriva da _TheClassNamefunzione di accesso. In Visualizzazione classi, verranno visualizzate entrambe le classi.
per un esempio di questo attributo utilizzato in un'applicazione, vedere gli esempi AtlAgent e MultiRead.
Esempio
Questo esempio viene chiamata db_source in una classe per creare una connessione a un'origine dati ds utilizzo del database Northwind. ds un handle per l'origine dati, che può essere utilizzata internamente a CMyCommand classe.
// 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 {};
Requisiti
contesto di attributo
Si applica a |
classe, struct, membro, metodo, locale |
ripetibile |
No |
attributi obbligatori |
Nessuno |
attributi non validi |
Nessuno |
per ulteriori informazioni sui contesti di attributo, vedere Associare ai contesti.