db_column

Articolo
02/19/2013

Associa una colonna specificata a una variabile nel rowset.

[ db_column( 
   ordinal, 
   dbtype, 
   precision, 
   scale, 
   status, 
   length 
) ]

Parametri

ordinal
il numero di colonne ordinale (DBCOLUMNINFO ordinale) o nome della colonna (ANSI o stringa Unicode) che corrisponde a un campo del rowset che per l'associazione dati.Se si utilizzano i numeri, è possibile ignorare gli ordinali consecutivi (ad esempio: 1, 2, 3, 5).Il nome può contenere spazi se il provider OLE DB si utilizza i contenuti multimediali.Ad esempio, è possibile utilizzare uno dei seguenti formati:
```
[db_column("2")] TCHAR szCity[30];
[db_column(L"city_name")] TCHAR szCity[30];
```
dbtype (facoltativo)
Un OLE DB Indicatore del tipo per la voce della colonna.
precisione (facoltativo)
La precisione da utilizzare per la voce della colonna.Per informazioni dettagliate, vedere la descrizione di bPrecision elemento di struttura di DBBINDING
ridimensionamento (facoltativo)
La scala da utilizzare per la voce della colonna.Per informazioni dettagliate, vedere la descrizione di bScale elemento di struttura di DBBINDING
lo stato (facoltativo)
Una variabile membro utilizzato per utilizzare lo stato di questa colonna.Lo stato indica se il valore della colonna è un valore di dati o un altro valore, ad esempio NULL.per i valori possibili, vedere lo stato in OLE DB Programmer's Reference.
durata (facoltativo)
Una variabile membro utilizzato per utilizzare la dimensione della colonna in byte.

Note

db_column associa la colonna della tabella specificata a una variabile nel rowset.Delimita i dati dei membri che possono partecipare a OLE DB IAccessorassociazione basata.Questo attributo è installato la mappa delle colonne in genere definita utilizzando le macro consumer OLE DB BEGIN_COLUMN_MAP, END_COLUMN_MAPe COLUMN_ENTRY.Questi cambiano OLE DB struttura di DBBINDING per associare la colonna specificata.Ogni membro di segnate con db_column l'attributo occuperà una voce nella mappa delle colonne sotto forma di voce della colonna.Di conseguenza, si chiama questo attributo in cui viene inserita la mappa delle colonne, ovvero, nella classe di comando o di tabella.

utilizzo db_column insieme a uno db_table o db_command attributi.

Quando il provider di tipo consumer di attributo applicato questo attributo a una classe, il compilatore la classe a _TheClassNamefunzione di accesso, dove TheClassName è il nome assegnato alla classe e il compilatore inoltre creata una classe denominata TheClassName, quale deriva da _TheClassNamefunzione di accesso.In Visualizzazione classi, verranno visualizzate entrambe le classi.

Per esempi di questo attributo utilizzato in un'applicazione, vedere gli esempi AtlAgente MultiRead.

Esempio

Questo esempio si associa una colonna in una tabella a un oggetto tempo il membro dati e specificare i campi di stato e di lunghezza.

// db_column_1.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>

[ db_command(L"Select * from Products") ]
class CProducts {
   DBSTATUS m_dwProductIDStatus;
   DBLENGTH m_dwProductIDLength;

   [ db_column("1", status="m_dwProductIDStatus", length="m_dwProductIDLength") ] LONG m_ProductID;
};

Nell'esempio viene associato quattro colonne a un oggetto tempo, una stringa di caratteri, un timestamp e DB_NUMERIC Integer, in questo ordine.

// db_column_2.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>

[ db_command(L"Select * from Products") ]
class CProducts {
   [db_column("1")] LONG m_OrderID;
   [db_column("2")] TCHAR m_CustomerID[6];
   [db_column("4")] DB_NUMERIC m_OrderDate;   
   [db_column("7", dbtype="DBTYPE_NUMERIC")] DB_NUMERIC m_ShipVia;
};

Requisiti

contesto di attributo

Si applica a	classe, struct, membro, metodo
ripetibile	No
attributi obbligatori	Nessuno
attributi non validi	Nessuno

per ulteriori informazioni sui contesti di attributo, vedere Associare ai contesti.

Vedere anche

Altre risorse

Attributi del consumer OLE DB

Attributi di classe

Attributes Samples

Condividi tramite