db_source
crée une connexion à une source de données.
[ 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 le format de la chaîne de connexion, consultez Chaînes de connexion et les liaisons de données dans Microsoft Data Access Components (MDAC) SDK.nom (facultatif)
Lorsque vous utilisez db_source sur une classe, le nom est une instance d'un objet source de données qui contient l'attribut d' db_source appliqué à elle (voir l'exemple 1). Lorsque vous utilisez db_source inline dans une implémentation de méthode, le nom est une variable (local à 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 d' source_name de db_command pour associer la source de données avec 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 sera automatiquement injectée par l'attribut.
Notes
db_source crée CDataSource et un objet de CSession , qui représentent ensemble une connexion à une source de données du consommateur OLE DB.
Lorsque vous utilisez db_source sur une classe, l'objet d' CSession devient un membre de la classe.
Lorsque vous utilisez db_source dans une méthode, le code injecté sera exécuté dans la portée de la méthode, et l'objet d' CSession est créé comme variable locale.
db_source ajoute des propriétés de la source de données à une classe ou dans une méthode. Il est utilisé avec db_command (qui acceptele paramètre name d' db_sourcecomme paramètre d' source_name ).
Lorsque le fournisseur d'attributs du consommateur applique cet attribut à une classe, le compilateur renommera la classe au _YourClassNameAccessor, 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 les exemples AtlAgent et MultiRead.
Exemple
Cet exemple appelle db_source sur une classe pour créer une connexion à la source de données ds utilisation de la base de données Northwind. ds est un handle de la source de données, qui peut être utilisée en interne à la classe d' 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 {};
Configuration requise
contexte d'attribut
S'applique à |
classe, struct, membre, méthode, les variables locales |
reproductible |
Non |
attributs requis |
Aucun |
attributs valides |
Aucun |
Pour plus d'informations sur les contextes d'attribut, consultez contextes d'attribut.