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

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

Voir aussi

Attributs du consommateur OLE DB