Partager via


db_table

Ouvre une table OLE DB.

[ 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 (tel que « products »).

  • nom (facultatif)
    Le nom du handle que vous utilisez pour utiliser le tableau.Vous devez spécifier ce paramètre si vous souhaitez retourner plusieurs lignes de résultats.db_table génère une variable avec le nom spécifié peut être utilisé pour parcourir l'ensemble de lignes ou pour exécuter plusieurs requêtes Action.

  • source_name (facultatif)
    La variable d' CSession ou l'instance d'une classe qui a l'attribut d' db_source appliquée à celui-ci sur lequel la commande s'exécute.Consultez 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 sera automatiquement injectée par l'attribut.

Notes

db_table crée un objet de CTable , qui est utilisé par un consommateur OLE DB pour ouvrir un tableau.Vous pouvez utiliser cet attribut uniquement au niveau de la classe ; vous ne pouvez pas utiliser inline.utilisation db_column de lier des colonnes de table aux variables ; utilisez db_param pour le délimiter (défini le type de paramètre etc.) des paramètres.

Lorsque le fournisseur d'attributs du consommateur applique cet attribut à une classe, le compilateur renommera la classe au _YourClassNameAccessor, 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 pour une utilisation par d' 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 les exemples AtlAgent et MultiRead.

Configuration requise

contexte d'attribut

S'applique à

classe, struct

reproductible

Non

attributs requis

Aucun

attributs valides

Aucun

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

Voir aussi

Autres ressources

Attributs du consommateur OLE DB

Attributes Samples