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.