CRecordset::DoBulkFieldExchange
Chiamato per lo scambio di massa di righe di dati da un'origine dati al recordset.Bulk Record Field Exchange di risorse (RFX di massa.
virtual void DoBulkFieldExchange(
CFieldExchange* pFX
);
Parametri
- pFX
Un puntatore a un oggetto CFieldExchange.Il framework avrà già installato questo oggetto per specificare un contesto per l'operazione di trasferimento di campi.
Note
Quando il recupero di massa di righe viene distribuito, il framework chiama la funzione membro automaticamente per trasferire i dati dall'origine dati all'oggetto recordset.DoBulkFieldExchange si associa i membri dati di parametro, se presente, ai segnaposto dei parametri nella stringa di un'istruzione SQL per la selezione del recordset.
Se il recupero di massa di righe non viene implementato, il framework chiama DoFieldExchange.Per implementare il recupero di massa di righe, è necessario specificare l'opzione CRecordset::useMultiRowFetch del parametro dwOptions nella funzione membro Apri.
[!NOTA]
DoBulkFieldExchange è disponibile solo se si utilizza una classe derivata da CRecordset.Se si è creato un oggetto recordset direttamente da CRecordset, è necessario chiamare la funzione membro GetFieldValue per recuperare i dati.
Il l'rfx di massa è simile al trasferimento di campi di Record.Automaticamente i dati vengono trasferiti dall'origine dati all'oggetto recordset.Tuttavia, non è possibile chiamare AddNew, Modifica, Elimina, o Aggiorna per trasferire le modifiche all'origine dati.La classe CRecordset attualmente non fornisce un meccanismo per l'aggiornamento di massa di righe di dati; tuttavia, è possibile scrivere funzioni personalizzate utilizzando la funzione API ODBC SQLSetPos.
Si noti che ClassWizard non supporta il trasferimento di massa di campi di Record, pertanto, è necessario eseguire l'override DoBulkFieldExchange scrivendo manualmente le chiamate alle funzioni RFX di massa.Per ulteriori informazioni su queste funzioni, vedere l'argomento Funzioni di trasferimento di campi di Record.
Per ulteriori informazioni sul recupero di massa di righe, vedere l'articolo recordset: Recupero di massa di record (ODBC).Per informazioni correlate, vedere l'articolo Trasferimento di campi di Record.
Eccezioni
Questo metodo può generare eccezioni di tipo CDBException*.
Requisiti
Header: afxdb.h