Compartir a través de


Intercambio de campos de registros: Utilizar las funciones de RFX

Actualización: noviembre 2007

Este tema explica cómo usar las llamadas de función RFX que componen el cuerpo de una función de reemplazo de DoFieldExchange.

Nota:

Este tema es aplicable a las clases derivadas de CRecordset donde la obtención masiva de filas no está implementada. Si usa la obtención masiva de filas, se implementará el intercambio masivo de campos de registros (RFX masivo). RFX masivo es similar a RFX. Para comprender mejor estas diferencias, vea Conjunto de registros: obtener registros de forma masiva (ODBC).

Las funciones globales de RFX intercambian datos entre las columnas del origen de datos y los miembros de datos de campo del conjunto de registros. Las llamadas de función RFX se escriben en la función miembro DoFieldExchange del conjunto de registros. Este tema describe las funciones brevemente y muestra los tipos de datos para los que están disponibles las funciones de RFX. La Nota técnica 43 describe cómo escribir sus propias funciones RFX para tipos de datos adicionales.

Sintaxis de las funciones RFX

Cada función RFX toma tres parámetros (algunos toman un cuarto o quinto parámetro opcional):

  • Un puntero a un objeto CFieldExchange. Basta con pasar el puntero pFX pasado a DoFieldExchange.

  • El nombre de la columna tal como aparece en el origen de datos.

  • El nombre del miembro de datos de campo o de parámetro correspondiente en la clase de conjunto de registros.

  • (Opcional) En algunas funciones, la longitud máxima de la cadena o matriz que se está transfiriendo. El valor predeterminado es 255 bytes, pero se puede modificar. El tamaño máximo está basado en el tamaño máximo de un objeto CString: INT_MAX (2.147.483.647) bytes, pero probablemente encontrará límites en el controlador antes de llegar a ese tamaño.

  • (Opcional) En la función RFX_Text, a veces se utiliza un quinto parámetro para especificar el tipo de datos de una columna.

Para obtener más información, vea las funciones RFX en Macros y funciones globales en la Referencia de la biblioteca de clases. Para obtener un ejemplo de cuándo se puede hacer un uso especial de los parámetros, vea Conjunto de registros: Obtener cálculos SUM y otros resultados agregados (ODBC).

Tipos de datos RFX

La biblioteca de clases proporciona funciones RFX para transferir varios tipos de datos diferentes entre el origen de datos y los conjuntos de registros. La siguiente lista resume las funciones RFX por tipo de datos. En los casos en que es necesario escribir sus propias llamadas de función RFX, seleccione funciones de esta lista por el tipo de datos.

Función

Tipo de datos

RFX_Bool

BOOL

RFX_Byte

BYTE

RFX_Binary

CByteArray

RFX_Double

double

RFX_Single

float

RFX_Int

int

RFX_Long

long

RFX_LongBinary

CLongBinary

RFX_Text

CString

RFX_Date

CTime

Para obtener más información, vea la documentación de las funciones RFX en Macros y funciones globales en la Referencia de la biblioteca de clases. Para obtener más información sobre la correspondencia entre los tipos de datos de SQL y de C++, vea la tabla Correspondencia entre tipos de datos de ANSI SQL y de C++ en SQL: tipos de datos de SQL y C++ (ODBC).

Vea también

Conceptos

Intercambio de campos de registros (RFX)

Intercambio de campos de registros: Funcionamiento de RFX

Conjunto de registros: Parametrizar un conjunto de registros (ODBC)

Conjunto de registros: Enlazar dinámicamente columnas de datos (ODBC)

Referencia

CRecordset Class

CFieldExchange Class