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 »).
name
(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 | Value |
---|---|
S’applique à | class , struct |
Renouvelable | Non |
Attributs requis | Aucun |
Attributs non valides | Aucun |
Pour plus d'informations sur les contextes d'attribut, consultez Contextes d'attribut.
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour