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
| Contesto attributo | Valore |
|---|---|
| Si applica a | class, struct |
| Ripetibile | No |
| Attributi obbligatori | None |
| Attributi non validi | None |
Per altre informazioni sui contesti di attributi, vedere Contesti di attributi.