Freigeben über


db_column

Bindet eine angegebene Spalte auf eine Variable im Rowset.

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

Parameter

  • ordinal
    Der ordinale Spaltennummer (DBCOLUMNINFO Ordnungszahl) oder Spaltenname (ANSI oder Unicode-Zeichenfolge) entspricht einem Feld im Rowset, um Daten zu binden.Wenn Sie Zahlen verwenden, können Sie nachfolgende Ordnungszahlen überspringen (z. B.: 1, 2, 3, 5).Der Name enthält möglicherweise leer, wenn der OLE DB-Anbieter, den Sie verwenden sie unterstützen.Sie können z. B. eines der folgenden Formate aufweisen:

    [db_column("2")] TCHAR szCity[30];
    [db_column(L"city_name")] TCHAR szCity[30];
    
  • dbtype (optional)
    OLE DB Typ-Indikator für den Eintrag Spalten.

  • Genauigkeit (optional)
    Die für den Eintrag Spalten zu verwendenden Genauigkeit.Weitere Informationen finden Sie in der Beschreibung des bPrecision-Elements DBBINDING-Struktur

  • Dezimalstellen (optional)
    Die für den Eintrag Spalten, Skalierung verwendet werden soll.Ausführliche Informationen finden Sie in der Beschreibung von bScale-Element DBBINDING-Struktur

  • Status (optional)
    Eine Membervariable verwendet, um den Status dieser Spalte enthält.Der Status gibt, ob der Spaltenwert ein Datenwert oder ein anderer Wert ist, z NULLan.Mögliche Werte finden Sie in der StatusOLE DB-Programmierreferenz.

  • Length (optional)
    Eine Membervariable verwendet, um die Größe der Spalte in Bytes enthält.

Hinweise

db_column bindet die angegebene Tabellenspalte auf eine Variable im Rowset.Sie schränkt Memberdaten ab, die an er-basiert Bindung in OLE DB IAccessorteilnehmen können.Dieses Attribut richtet die Spaltenzuordnung, die normalerweise mithilfe der OLE DB-Consumer-Makros BEGIN_COLUMN_MAP, END_COLUMN_MAPund COLUMN_ENTRYdefiniert wurde.Diese bearbeiten OLE DB DBBINDING-Struktur , um die angegebene Spalte gebunden wird.Jeder Member, den Sie mit dem db_column-Attribut kennzeichnen, nimmt einen Eintrag in der Spaltenzuordnung in Form eines Spalten Zieleintrags.Daher rufen Sie dieses Attribut an, in dem Sie die Spaltenzuordnung, d. h. in den Befehl oder die Tabellenklasse einfügen würden.

Verwenden Sie db_column entweder in Verbindung mit den db_table oder db_command-Attributen.

Wenn der Consumer Attribut für Textanbieter dieses Attribut auf eine Klasse angewendet wird, benennt der Compiler die Klasse zum _TheClassNameAccessor, in dem TheClassName der Name ist, den Sie für die Klasse haben, und der Compiler außerdem eine Klasse erstellt, die TheClassName aufgerufen wird , die vom _TheClassNameAccessor berechnet.In der Klassenansicht finden Sie unter beide Klassen.

Beispiele dieses Attributs, das in einer Anwendung verwendet wird, finden Sie in den Beispielen AtlAgentund MultiRead.

Beispiel

In diesem Beispiel umschließt eine Spalte in einer Tabelle zu einem long Datenmember und gibt Datenmember für Status und Länge Feldern an.

// 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;
};

In diesem Beispiel umschließt vier Spalten long, einer Zeichenfolge, einen Zeitstempel und eine DB_NUMERIC Ganzzahl, in dieser Reihenfolge.

// 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;
};

Anforderungen

Attribut-Kontext

Betrifft

Klasse, struct, Member, Methode

Wiederholbar

Nein

Erforderliche Attribute

None

Ungültige Attribute

None

Weitere Informationen über das kontexte finden Sie unter Attribut-Kontexte.

Siehe auch

Weitere Ressourcen

OLE DB-Consumerattribute

Klassen-Attribute

Attributes Samples