db_table
Ouvre une table OLE DB.
Syntaxe
[ db_table(db_table, name, source_name, hresult) ]
Paramètres
db_table
Chaîne spécifiant le nom d’une table de base de données (par exemple, « Produits »).
nom
(Facultatif) Nom du handle que vous utilisez pour utiliser la table. Vous devez spécifier ce paramètre si vous souhaitez retourner plusieurs lignes de résultats. db_table génère une variable portant le nom spécifié qui peut être utilisée pour parcourir l’ensemble de lignes ou exécuter plusieurs requêtes d’action.
source_name
(Facultatif) Variable CSession ou instance d’une classe qui a l’attribut db_source appliqué à celle-ci sur laquelle la commande s’exécute. Voir db_source.
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_table crée un objet CTable, utilisé par un consommateur OLE DB pour ouvrir une table. Vous pouvez utiliser cet attribut uniquement au niveau de la classe ; vous ne pouvez pas l’utiliser inline. Permet db_column de lier des colonnes de table à des variables ; utilisez db_param pour délimiter (définir le type de paramètre, et ainsi de suite) des paramètres.
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.
Exemple
L’exemple suivant ouvre la table Products à utiliser par CProducts.
// db_table.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>
[ db_table(L"dbo.Products") ]
class CProducts {
[ db_column("1") ] LONG m_ProductID;
};
Pour obtenir un exemple de cet attribut utilisé dans une application, consultez MultiRead.
Spécifications
| Contexte d’attribut | Valeur |
|---|---|
| S’applique à | class, struct |
| Renouvelable | Non |
| Attributs requis | Aucune |
| Attributs non valides | Aucune |
Pour plus d'informations sur les contextes d'attribut, consultez Contextes d'attribut.