Datensatzfeldaustausch: Verwenden der RFX-Funktionen

Artikel
02/26/2013

In diesem Thema wird erläutert, wie Sie die RFX-Funktionsaufrufe verwenden, die das Kernstück der DoFieldExchange-Überschreibung bilden.

Hinweis
Dieses Thema bezieht sich auf von CRecordset abgeleitete Klassen, in denen der gesammelte Zeilenabruf nicht implementiert wurde.Beim gesammelten Abrufen von Zeilen wird der Sammel-Datensatzfeldaustausch (Bulk-RFX) implementiert.Der Bulk-RFX ist mit RFX vergleichbar.Unter Recordset: Abrufen von Datensätzen in einer Sammeloperation (ODBC) werden die Unterschiede erläutert.

Die globalen RFX-Funktionen übertragen Daten zwischen Spalten der Datenquelle und Felddatenmembern des Recordsets.Sie erstellen die RFX-Funktionsaufrufe in der DoFieldExchange-Memberfunktion des Recordsets.In diesem Thema werden diese Funktionen kurz beschrieben und die Datentypen aufgeführt, für die RFX-Funktionen zur Verfügung stehen.Der Technische Hinweis 43 beschreibt, wie Sie für zusätzliche Datentypen eigene RFX-Funktionen erstellen können.

Syntax der RFX-Funktionen

Jede RFX-Funktion verfügt über drei Parameter (manche haben zusätzlich einen optionalen vierten und fünften Parameter):

Einen Zeiger auf ein CFieldExchange-Objekt.Sie übergeben einfach den an DoFieldExchange übergebenen pFX-Zeiger.
Den Namen der Spalte, wie er in der Datenquelle angezeigt wird.
Den Namen des zugehörigen Felddatenmembers oder Parameterdatenmembers in der Recordset-Klasse.
(Optional) In manchen Funktionen die Maximallänge der Zeichenfolge oder des Arrays, das übertragen wird.Der Standardwert beträgt 255 Bytes, kann aber bei Bedarf geändert werden.Die Maximalgröße leitet sich von der Maximalgröße eines CString-Objekts ab (INT_MAX (2.147.483.647 Bytes)), meist treten aber schon vor Erreichen dieser Grenze Einschränkungen des Treibers in Kraft;
(Optional) In der Funktion RFX_Text legen Sie manchmal in einem fünften Parameter den Datentyp einer Spalte fest.

Weitere Informationen finden Sie in der Dokumentation der RFX-Funktionen unter Macros and Globals (nur auf Englisch verfügbar) in der Class Library Reference.Ein Beispiel für die spezielle Verwendung von Parametern finden Sie unter Recordset: Abrufen von SUMs und anderen Aggregatergebnissen (ODBC).

RFX-Datentypen

Die Klassenbibliothek stellt RFX-Funktionen für die Übertragung vieler verschiedener Datentypen zwischen der Datenquelle und den Recordsets zur Verfügung.In der folgenden Liste sind die RFX-Funktionen nach Datentyp zusammengefasst.Falls Sie eigene RFX-Funktionsaufrufe erstellen möchten, können Sie anhand des Datentyps in dieser Liste die richtige Funktion auswählen.

Funktion	Datentyp
RFX_Bool	BOOL
RFX_Byte	BYTE
RFX_Binary	CByteArray
RFX_Double	double
RFX_Single	float
RFX_Int	int
RFX_Long	long
RFX_LongBinary	CLongBinary
RFX_Text	CString
RFX_Date	CTime

Weitere Informationen finden Sie in der Dokumentation der RFX-Funktionen unter Macros and Globals (nur auf Englisch verfügbar) in der Class Library Reference.Informationen über die Zuordnung von C++-Datentypen zu SQL-Datentypen finden Sie in der Zuordnungstabelle zwischen C++-Datentypen und ANSI-SQL-Datentypen unter SQL: SQL- und C++-Datentypen (ODBC).