Trasferimento di campi di record: utilizzo delle funzioni RFX

Articolo
03/05/2013

In questo argomento viene descritto l'utilizzo delle chiamate alle funzioni RFX che costituiscono il corpo dell'override di DoFieldExchange.

[!NOTA]

L'argomento è relativo alle classi derivate da CRecordset per cui il recupero di massa di righe non è ancora stato implementato.Se si sta utilizzando il recupero di massa di righe, verrà implementato l'RFX di massa.L'RFX di massa è simile all'RFX.Per comprenderne le differenze, vedere Recordset: recupero di massa di record (ODBC).

Le funzioni globali di RFX consentono lo scambio di dati tra le colonne dell'origine dati e i membri dati di campo del recordset.È necessario scrivere le chiamate alle funzioni RFX nella funzione membro DoFieldExchange del recordset.In questo argomento viene fornita una breve descrizione delle funzioni e vengono illustrati i tipi di dati per i quali sono disponibili le funzioni RFX.Nella Nota tecnica 43 viene descritta la scrittura delle funzioni RFX per altri tipi di dati.

Sintassi delle funzioni RFX

Ciascuna funzione RFX utilizza tre parametri, elencati di seguito. Solo alcune utilizzano un quarto o un quinto parametro facoltativo.

Un puntatore a un oggetto CFieldExchange.È sufficiente utilizzare il puntatore pFX passato a DoFieldExchange.
Il nome della colonna presente nell'origine dati.
Il nome del membro dati di campo o del membro dati di parametro corrispondente nella classe recordset.
(Facoltativo) In alcune funzioni, la lunghezza massima della stringa o della matrice da trasferire.L'impostazione predefinita è di 255 byte, ma è possibile modificarla.La dimensione massima si basa sulle dimensioni massime di un oggetto CString, ovvero INT_MAX (2.147.483.647) byte, ma, prima di raggiungere questo valore, è probabile che si incontrino i limiti del driver.
(Facoltativo) Nella funzione RFX_Text talvolta è necessario utilizzare un quinto parametro per specificare il tipo di dati di una colonna.

Per ulteriori informazioni, vedere gli argomenti relativi alle funzioni RFX in Macro e funzioni globali in Riferimenti alla libreria di classi.Per un esempio di utilizzo speciale dei parametri, vedere Recordset: recupero di somme e altri risultati aggregati (ODBC).

Tipi di dati RFX

La libreria di classi rende disponibili le funzioni RFX per lo scambio di molti tipi diversi di dati tra l'origine dati e i recordset.Nell'elenco riportato di seguito vengono riepilogate le funzioni RFX in base al tipo di dati.Nei casi in cui sia necessario scrivere le chiamate alle funzioni RFX, scegliere una delle funzioni riportate di seguito in base al tipo di dati.

Funzione	Tipo di dati
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

Per ulteriori informazioni, vedere la documentazione sulle funzioni RFX in Macro e funzioni globali in Riferimenti alla libreria di classi.Per informazioni sulle corrispondenze tra tipi di dati C++ e SQL, vedere la tabella Tipi di dati SQL ANSI e corrispondenti tipi di dati C++ in SQL: tipi di dati SQL e C++ (ODBC).