db_table
Ouvre une table OLE DB.
[ db_table(db_table, name, source_name, hresult) ]
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.
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.
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.
Contexte d’attribut | Valeur |
---|---|
S’applique à | class , struct |
Renouvelable | Non |
Attributs requis | Aucun(e) |
Attributs non valides | Aucun(e) |
Pour plus d'informations sur les contextes d'attribut, consultez Contextes d'attribut.