db_source

Crée une connexion à une source de données.

Syntaxe

[ db_source(db_source, name, hresult) ]

Paramètres

db_source
La chaîne de connexion utilisée pour se connecter à la source de données. Pour connaître le format de l’chaîne de connexion, consultez Connecter chaînes et liens de données dans le KIT SDK Microsoft Data Access Components (MDAC).

name
(Facultatif) Lorsque vous utilisez db_source sur une classe, le nom est une instance d’un objet source de données dont l’attribut db_source lui est appliqué (voir l’exemple 1). Lorsque vous utilisez db_source inline dans une implémentation de méthode, le nom est une variable (locale à la méthode) qui peut être utilisée pour accéder à la source de données (voir l’exemple 2). Vous passez ce nom au paramètre source_name de l’association de la source de db_command données à une commande.

Hresult
(Facultatif) Identifie la variable qui recevra hrESULT de cette commande de base de données. Si la variable n’existe pas, elle est injectée automatiquement par l’attribut.

Notes

db_source crée un objet CDataSource et CSession, qui représentent ensemble une connexion avec une source de données consommateur OLE DB.

Lorsque vous utilisez db_source sur une classe, l’objet CSession devient membre de la classe.

Lorsque vous utilisez db_source dans une méthode, le code injecté est exécuté dans l’étendue de la méthode et l’objet CSession est créé en tant que variable locale.

db_source ajoute des propriétés de source de données à une classe ou dans une méthode. Il est utilisé conjointement avec db_command (qui prend le paramètre de nom db_sourcecomme paramètre source_name).

Lorsque le fournisseur d’attributs consommateur applique cet attribut à une classe, le compilateur renomme la classe en _YourClassName Accessor, où YourClassName est le nom que vous avez donné à la classe, et le compilateur crée également une classe appelée YourClassName, qui dérive de _YourClassNameAccessor. Dans l’affichage de classes, vous verrez les deux classes.

Pour obtenir un exemple de cet attribut utilisé dans une application, consultez MultiRead.

Exemple

Cet exemple appelle db_source sur une classe pour créer une connexion à la source ds de données à l’aide de la base de données Northwind. ds est un handle pour la source de données, qui peut être utilisé en interne pour la 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 {};

Spécifications

Contexte d’attribut	Value
S’applique à	class, membre struct, méthode, local
Renouvelable	Non
Attributs requis	Aucun
Attributs non valides	Aucun

Pour plus d'informations sur les contextes d'attribut, consultez Contextes d'attribut.

Voir aussi

Attributs du consommateur OLE DB