Partager via


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.

Voir aussi

Attributs du consommateur OLE DB