Trasferimento di campi di record: utilizzo delle funzioni RFX
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).
Vedere anche
Riferimenti
Concetti
Trasferimento di campi di record (RFX)
Trasferimento di campi di record: funzionamento di RFX