db_table

Apre una tabella OLE DB.

Sintassi

[ db_table(db_table, name, source_name, hresult) ]

Parametri

db_table
Stringa che specifica il nome di una tabella di database, ad esempio "Products".

name
(Facoltativo) Nome dell'handle utilizzato per lavorare con la tabella. È necessario specificare questo parametro se si desidera restituire più righe di risultati. db_table genera una variabile con il nome specificato che può essere usata per attraversare il set di righe o eseguire più query di azione.

source_name
(Facoltativo) La variabile CSession o l'istanza di una classe a cui è applicato l'attributo db_source con cui viene eseguito il comando. Vedere db_source.

hresult
(Facoltativo) Identifica la variabile che riceverà l'HRESULT di questo comando di database. Se la variabile non esiste, verrà automaticamente inserita dall'attributo.

Osservazioni:

db_table crea un oggetto CTable, utilizzato da un consumer OLE DB per aprire una tabella. È possibile usare questo attributo solo a livello di classe; non è possibile usarlo inline. Utilizzare per associare colonne di tabella a variabili. Usare db_column db_param per delimitare (impostare il tipo di parametro e così via) dei parametri.

Quando il provider di attributi consumer applica questo attributo a una classe, il compilatore rinomina la classe in _YourClassNameFunzione di accesso, dove YourClassName è il nome assegnato alla classe e il compilatore creerà anche una classe denominata YourClassName, che deriva dalla funzione di accesso _YourClassName. In Visualizzazione classi verranno visualizzate entrambe le classi.

Esempio

Nell'esempio seguente viene aperta la tabella Products per l'utilizzo da parte di 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;
};

Per un esempio di questo attributo usato in un'applicazione, vedere MultiRead.

Requisiti

Per altre informazioni sui contesti di attributi, vedere Contesti di attributi.

Vedi anche

Attributi del consumer OLE DB