CRecordset::DoBulkFieldExchange
Appelé pour échanger les lignes en bloc de données de la source de données vers le recordset.Mécanisme RFX en bloc d'outils (bulk RFX).
virtual void DoBulkFieldExchange(
CFieldExchange* pFX
);
Paramètres
- pFX
Un pointeur vers un objet CFieldExchange.L'infrastructure aura déjà installé cet objet pour spécifier un contexte pour l'exécution d'échange des champs.
Notes
Lorsque l'extraction de lignes en bloc est implémentée, l'infrastructure appelle cette fonction membre pour transférer automatiquement des données de la source de données à l'objet recordset.DoBulkFieldExchange lie également les membres de données de type paramètre, le cas échéant, aux emplacements de paramètres réservés dans la chaîne d'instruction SQL pour la sélection du recordset.
Si l'extraction de lignes en bloc n'est pas implémentée, l'infrastructure appelle DoFieldExchange.Pour implémenter l'extraction de lignes en bloc, vous devez spécifier l'option d' CRecordset::useMultiRowFetch du paramètre d' dwOptions dans la fonction membre d' Ouvrez .
[!REMARQUE]
DoBulkFieldExchange est disponible uniquement si vous utilisez une classe dérivée d' CRecordset.Si vous avez créé un objet recordset directement d' CRecordset, vous devez appeler la fonction membre de GetFieldValue pour récupérer des données.
Le mécanisme RFX en bloc (bulk RFX) est semblable à l'record field exchange (bulk RFX).Les données sont transférées automatiquement de la source de données et l'objet recordset.Toutefois, vous ne pouvez pas appeler AddNew, Modifier, Supprimer, ou Mettre à jour pour transférer les modifications dans la source de données.La classe CRecordset actuel ne fournit pas de mécanisme pour mettre à jour les lignes en bloc de données ; toutefois, vous pouvez écrire vos propres fonctions à l'aide de la fonction API ODBC SQLSetPos.
Notez que assistant classe ne prend pas en charge le mécanisme RFX en bloc ; par conséquent, vous devez substituer DoBulkFieldExchange manuellement en écrivant des appels aux fonctions RFX en bloc.Pour plus d'informations sur ces fonctions, consultez la rubrique Fonctions de création de rapports d'échange des champs.
Pour plus d'informations sur l'extraction de lignes en bloc, consultez l'article recordset : Extraction globale d'enregistrements (ODBC).Pour des informations connexes, consultez l'article Enregistrez l'échange des champs (RFX).
Exceptions
Cette méthode peut lever des exceptions de type CDBException*.
Configuration requise
Header: afxdb.h