Datensatzfeldaustausch: Verwenden der RFX-Funktionen

Artikel
09/02/2008

Aktualisiert: November 2007

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).