Condividi tramite

CRecordset::DoBulkFieldExchange

  • Articolo

 

Pubblicato: aprile 2016

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.

Sintassi

      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

Exception

Condition

Questo metodo può generare eccezioni di tipo CDBException*.

Requisiti

Header: afxdb.h

Vedere anche

CRecordset Class
Grafico delle gerarchie
CRecordset::m_nFields
CRecordset::m_nParams
CRecordset::DoFieldExchange
CRecordset::GetFieldValue
CFieldExchange Class
Funzioni di trasferimento di campi di record