CRecordset::DoBulkFieldExchange

 

Denominado para cambiar filas masivas de datos desde el origen de datos al conjunto de registros.  Implementa el intercambio masivo de campos de registros (RFX Masivo).  

Sintaxis

      virtual void DoBulkFieldExchange( 
   CFieldExchange* pFX  
);

Parámetros

• pFX
  Un puntero a un objeto CFieldExchange.  El marco ya tendrá configuración este objeto para especificar un contexto para la operación de intercambio de campos.  

Comentarios

Cuando se implementa la obtención masiva de filas, el marco de trabajo llama a esta función miembro automáticamente para transferir datos desde el origen de datos al objeto de conjunto de registros.  DoBulkFieldExchange también enlaza a los miembros de datos de parámetro, si existe, los marcadores de parámetros en la cadena de instrucción SQL para la selección de conjunto de registros.  

Si la obtención masiva de filas no se implementa, el marco de trabajo llama a DoFieldExchange.  Para implementar la obtención de filas masiva, debe especificar la opción de CRecordset::useMultiRowFetch de parámetro de dwOptions en la función miembro de Abrir .  

Nota

DoBulkFieldExchange sólo está disponible si está utilizando una clase derivada de CRecordset.  Si ha creado un objeto de conjunto de registros directamente de CRecordset, se debe llamar a la función miembro de GetFieldValue para recuperar datos.  

El intercambio masivo de campos de registro (RFX Masivo) es similar al intercambio de campos de registros.  Los datos se transfiere de origen de datos al objeto de conjunto de registros.  Sin embargo, no puede llamar a AddNew, Editar, Eliminar, o Update para transferir los cambios al origen de datos.  La clase CRecordset no proporciona actualmente un mecanismo para actualizar filas masivas de datos; sin embargo, puede escribir las propias funciones mediante la función API SQLSetPosde ODBC.  

Observe que Pero no admite el intercambio masivo de campos de registros; por consiguiente, debe invalidar DoBulkFieldExchange manualmente escribiendo llamadas a las funciones de RFX Masivo.  Para obtener más información sobre estas funciones, vea el tema Funciones de intercambio de campos.  

Para obtener más información sobre la obtención masiva de filas, vea el artículo conjunto de registros: Obtener registros de forma masiva (ODBC).  Para obtener información relacionada, vea el artículo Intercambio de campos de registros.  

Excepciones

Exception

Condition

Este método puede producir excepciones de **CDBException***escrito.

Requisitos

encabezado: afxdb.h

Vea también

CRecordset Class
Gráfico de jerarquías
CRecordset::m_nFields
CRecordset::m_nParams
CRecordset::DoFieldExchange
CRecordset::GetFieldValue
CFieldExchange Class
Funciones de intercambio de campos de registros