Partager via

CRecordset::DoBulkFieldExchange

  • Article

 

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

Syntaxe

      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 .  

Notes

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

Exception

Condition

Cette méthode peut lever des exceptions de type CDBException*.

Configuration requise

Header: afxdb.h

Voir aussi

CRecordset Class
Graphique hiérarchique
CRecordset::m_nFields
CRecordset::m_nParams
CRecordset::DoFieldExchange
CRecordset::GetFieldValue
CFieldExchange Class
Fonctions Record Field Exchange (RFX)