Record Field Exchange : utilisation des fonctions RFX

Article
06/10/2015

Cette rubrique explique comment utiliser les appels de fonctions RFX qui constituent le corps de votre substitution de DoFieldExchange.

Notes

Cette rubrique s'applique aux classes dérivées de CRecordset dans lesquels l'extraction de lignes en bloc n'a pas été implémentée.Si vous utilisez l'extraction de lignes en bloc, le mécanisme RFX en bloc (Bulk RFX) est implémenté.RFX en bloc est similaire à RFX.Pour plus d'informations sur les différences, consultez Recordset : extraction globale d'enregistrements (ODBC).

Les fonctions globales RFX échangent les données entre les colonnes de la source de données et les membres de données de type champ du recordset. Vous écrivez les appels de fonction RFX dans la fonction membre DoFieldExchange de votre recordset. Cette rubrique décrit brièvement les fonctions et indique les types de données disponibles pour chaque fonction RFX. La Note technique 43 explique comment écrire ses propres fonctions RFX pour des types de données additionnels.

Syntaxe des fonctions RFX

Chaque fonction RFX nécessite trois paramètres (certaines admettent deux autres paramètres supplémentaires facultatifs) :

Un pointeur vers un objet CFieldExchange. Vous transmettez simplement le pointeur pFX passé à DoFieldExchange.
Nom de la colonne tel qu'il apparaît dans la source de données.
Nom du membre de données de champ ou de paramètre correspondant dans la classe de recordset.
(Facultatif) Dans certaines fonctions, la longueur maximale de la chaîne ou du tableau à transférer. Par défaut, cette longueur est de 255 octets, mais il se peut que vous souhaitiez la modifier. La taille maximale est fonction de la taille maximale d'un objet CString — INT_MAX (2 147 483 647) octets — mais vous vous heurterez probablement aux limites du pilote avant d'atteindre cette taille.
(Facultatif) Dans la fonction RFX_Text, vous utilisez quelquefois un cinquième paramètre pour définir le type de données d'une colonne.

Pour plus d'informations, consultez les fonctions RFX sous Macros and Globals dans Class Library Reference. Pour obtenir un exemple d'utilisation particulière des paramètres, consultez Recordset : calculs de totaux et autres résultats de regroupement (ODBC).

Types de données RFX

La bibliothèque de classes contient des fonctions RFX pour transférer plusieurs types de données différents entre la source de données et les recordsets. La liste ci-après résume les fonctions RFX par type de données. Lorsque vous devez écrire vos propres appels de fonction RFX, choisissez dans cette liste de fonctions selon le type de données.

Fonction	Type de données
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

Pour plus d'informations, consultez la documentation relative aux fonctions RFX sous Macros and Globals dans Class Library Reference. Pour plus d'informations sur la correspondance entre les types de données C++ et les types de données SQL, consultez le tableau « Mappage des types de données SQL ANSI et C++ » dans SQL : types de données SQL et C++ (ODBC).