Freigeben über


db_accessor

Gruppen db_column-Attribute, die an er-basiert Bindung IAccessorteilnehmen.

[ db_accessor( 
   num, 
   auto 
) ]

Parameter

  • num
    Gibt die Zahl an (Accessor einen nullbasierten ganzzahligen Index).Sie müssen in Zahlen Accessor mithilfe der Reihenfolge zunehmender ganze Zahlen oder der definierten Werte angeben.

  • Auto
    Ein boolescher Wert, der angibt, ob der Accessor automatisch abgerufenes (TRUE) ist oder nicht abgerufen (FALSE).

Hinweise

db_accessor definiert den zugrunde liegenden OLE DB-Accessor für folgende db_column und db_param-Attribute in der gleichen Klasse oder Funktion.db_accessor ist ein Member der Ebene verwendet werden und wird verwendet, um db_column-Attribute zu gruppieren, die an er-basiert Bindung in OLE DB IAccessorteilnehmen.Es wird entweder in Verbindung mit den db_table oder db_command-Attributen verwendet.Dieses Attribut aufrufen und BEGIN_ACCESSOR entspricht dem Aufrufen der END_ACCESSOR Makros vergleichbar.

db_accessor generiert ein Rowset und bindet es an den entsprechenden Accessor ist.Wenn Sie nicht db_accessoraufrufen, wird Accessor 0 automatisch generiert und Spaltenbindungen werden alle zu diesem Accessor Datenbindungsausdrücken zugeordnet.

db_accessor Gruppen datenbank-Spalten Befehlsbindungen in eine oder mehrere Accessoren.Ausführliche Informationen über die Szenarien, in denen mehrere Accessoren verwenden müssen, finden Sie unter Verwenden mehrerer Accessoren in einem Rowset.Siehe auch „Benutzer-Datensatz-Unterstützung für mehrere Accessoren“ in Benutzerdatensätze.

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.

Beispiel

Im folgenden Beispiel wird db_accessor , um Spalten aus der Tabelle Orders der Datenbank Northwind in zwei Accessoren zu gruppieren.Accessor 0 ist ein automatischer Accessor, und Accessor 1 ist nicht möglich.

// cpp_attr_ref_db_accessor.cpp
// compile with: /LD /link /OPT:NOREF
#define _ATL_ATTRIBUTES
#include <atlbase.h>
#include <atldbcli.h>

[ db_command(L"SELECT LastName, FirstName FROM Orders") ]
class CEmployees {
public:
   [ db_accessor(0, TRUE) ];
   [ db_column("1") ] LONG m_OrderID;
   [ db_column("2") ] TCHAR m_CustomerID[6];
   [ db_column("4") ] DBTIMESTAMP m_OrderDate; 

   [ db_accessor(1, FALSE) ];
   [ db_column("8") ] CURRENCY m_Freight;
};

Anforderungen

Attribut-Kontext

Betrifft

Attributblöcke

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

Attributes Samples