Freigeben über


CRecordset::DoBulkFieldExchange

Aufgerufen, um Massenzeilen von Daten aus der Datenquelle in das Recordset auszutauschen. Werkzeugmassen-datensatzfeldaustausch (Bulk-RFX).

virtual void DoBulkFieldExchange( 
   CFieldExchange* pFX  
);

Parameter

  • pFX
    Einen Zeiger auf ein CFieldExchange-Objekt. Das Framework hat bereits installiert dieses Objekt, um einen Kontext für den Feldaustauschvorgang anzugeben.

Hinweise

Wenn das gesammelte Abrufen von Zeilen implementiert wird, ruft das Framework diese Memberfunktion automatisch für Datenübertragung von der Datenquelle in das Recordset-Objekt auf. DoBulkFieldExchange bindet auch Parameterdatenmember ggf. an Parameterplatzhalter in der SQL-Anweisungszeichenfolge für die Auswahl des Recordsets.

Wenn das gesammelte Abrufen von Zeilen nicht implementiert wird, ruft das Framework DoFieldExchange auf. Um das gesammelte Abrufen von Zeilen zu implementieren, müssen Sie die Option dwOptionsCRecordset::useMultiRowFetch des Parameters in der Geöffnet-Memberfunktion angeben.

Hinweis

DoBulkFieldExchange ist nur verfügbar, wenn Sie eine Klasse verwenden, die von CRecordset abgeleitet wird.Wenn Sie ein Recordset-Objekt direkt von CRecordset erstellt haben, müssen Sie die GetFieldValue-Memberfunktion aufrufen, um Daten abzurufen.

Der Sammel-Datensatzfeldaustausch (Bulk-RFX) entspricht dem Datensatzfeldaustausch (RFX) ähnlich. Daten werden automatisch von der Datenquelle in das Recordset-Objekt übertragen. Sie können jedoch AddNew, Bearbeiten, Löschen oder Update nicht aufrufen, um Änderungen in der Datenquelle zu übertragen. - Klasse CRecordset derzeit stellt keinen Mechanismus zum Aktualisieren von Datenzeilen bereit; Sie können jedoch eigene Funktionen schreiben, indem Sie die ODBC-API-Funktion SQLSetPos verwenden.

Beachten Sie, dass Klassen-Assistent nicht den Sammel-Datensatzfeldaustausch unterstützt; Daher müssen Sie DoBulkFieldExchange manuell überschreiben, indem Sie Aufrufe der Bulk-RFX-Funktionen schreiben. Weitere Informationen zu diesen Funktionen, finden Sie im Thema Datensatzfeldaustausch-Funktionen.

Weitere Informationen über das gesammelte Abrufen von Zeilen, finden Sie im Artikel Recordset: Datensätzen in einer Sammeloperation (ODBC). Weitere Informationen finden Sie im Artikel Datensatzfeldaustausch (RFX).

Ausnahmen

Diese Methode kann Ausnahmen des Typs CDBException* auslösen.

Anforderungen

Header: afxdb.h

Siehe auch

Referenz

CRecordset-Klasse

Hierarchiediagramm

CRecordset::m_nFields

CRecordset::m_nParams

CRecordset::DoFieldExchange

CRecordset::GetFieldValue

CFieldExchange-Klasse

Weitere Ressourcen

Funktionen für den Datensatzfeldaustausch