db_source

Crea una connessione a un'origine dati.

Sintassi

[ db_source(db_source, name, hresult) ]

Parametri

db_source
Il stringa di connessione utilizzato per connettersi all'origine dati. Per il formato della stringa di connessione, vedere Stringhe di connessione e collegamenti dati in Microsoft Data Access Components (MDAC) SDK.

name
(Facoltativo) Quando si usa db_source in una classe, name è un'istanza di un oggetto origine dati a cui è applicato l'attributo db_source (vedere l'esempio 1). Quando si usa db_source inline in un'implementazione del metodo, name è una variabile (locale del metodo) che può essere usata per accedere all'origine dati (vedere l'esempio 2). Questo nome viene passato al parametro source_name di db_command per associare l'origine dati a un comando.

hresult
(Facoltativo) Identifica la variabile che riceverà l'HRESULT di questo comando di database. Se la variabile non esiste, verrà automaticamente inserita dall'attributo.

Osservazioni:

db_source crea un oggetto CDataSource e un oggetto CSession, che insieme rappresentano una connessione con un'origine dati consumer OLE DB.

Quando si usa db_source in una classe, l'oggetto CSession diventa un membro della classe .

Quando si usa db_source in un metodo, il codice inserito verrà eseguito nell'ambito del metodo e l'oggetto CSession viene creato come variabile locale.

db_source aggiunge proprietà dell'origine dati a una classe o all'interno di un metodo. Viene usato insieme db_command a (che accetta il parametro name db_source come parametro source_name).

Quando il provider di attributi consumer applica questo attributo a una classe, il compilatore rinomina la classe in _YourClassNameFunzione di accesso, dove YourClassName è il nome assegnato alla classe e il compilatore creerà anche una classe denominata YourClassName, che deriva dalla funzione di accesso _YourClassName. In Visualizzazione classi verranno visualizzate entrambe le classi.

Per un esempio di questo attributo usato in un'applicazione, vedere MultiRead.

Esempio

Questo esempio chiama db_source in una classe per creare una connessione all'origine ds dati usando il database Northwind. ds è un handle per l'origine dati, che può essere usata internamente alla 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 attributo	Valore
Si applica a	class, , structmembro, metodo, locale
Ripetibile	No
Attributi obbligatori	None
Attributi non validi	None

Per altre informazioni sui contesti di attributi, vedere Contesti di attributi.

Vedi anche

Attributi del consumer OLE DB