TN043: rutinas de RFX
[!NOTA]
La nota técnica siguiente no se ha actualizado desde que primero incluida en la documentación en línea.Como resultado, algunos procedimientos y temas podrían estar obsoletas o incorrectos.Para obtener la información más reciente, se recomienda busca el tema de interés en el índice de la documentación en línea.
Esta nota describe la arquitectura de intercambio de campos de registros.También describe cómo escribe un procedimiento de RFX_ .
Información general sobre el intercambio de campos de registros
Todas las funciones de campo de conjunto de registros se realizan mediante el código de C++.No hay recursos especiales o macros mágicas.El núcleo del mecanismo es una función virtual que se debe invalidar en cada clase derivada de conjunto de registros.Se encuentra siempre en este formulario:
void CMySet::DoFieldExchange(CFieldExchange* pFX)
{
//{{AFX_FIELD_MAP(CMySet)
<recordset exchange field type call>
<recordset exchange function call>
//}}AFX_FIELD_MAP
}
Los comentarios especiales de AFX de formato permiten que ClassWizard busque y editar el código en esta función.El código que no es compatible con ClassWizard debe colocarse fuera de los comentarios especiales de formato.
En el ejemplo anterior, <recordset_exchange_field_type_call> está en el formulario:
pFX->SetFieldType(CFieldExchange::outputColumn);
y <recordset_exchange_function_call> está en el formulario:
RFX_Custom(pFX, "Col2", m_Col2);
La mayoría de las funciones de RFX_ tienen tres argumentos como se indicó anteriormente, pero algunos (por ejemplo.RFX_Text y RFX_Binary) tienen argumentos opcionales adicionales.
Más de un RFX_ se puede incluir en cada función de DoDataExchange .
Vea “afxdb.h” para una lista de todas las rutinas de intercambio de campos de conjunto de registros proporcionadas MFC.
Las llamadas de campo de conjunto de registros son una manera de registrar las ubicaciones de memoria (normalmente miembros de datos) para almacenar los datos de campo para una clase de CMySet .
Notas
Las funciones de campo de conjunto de registros están diseñados para trabajar solo con las clases de CRecordset .No suelen usarse por otras clases MFC.
Los valores iniciales de datos se establecen en el constructor estándar de C++, normalmente en un bloque con //{{AFX_FIELD_INIT(CMylSet) y comentarios de //}}AFX_FIELD_INIT .
Cada función de RFX_ debe admitir varias operaciones, extendiéndose de devolver el estado modificado de campo a almacenar el campo con objeto de modificar el campo.
Cada función que llama a DoFieldExchange (por ejemplo SetFieldNull, IsFieldDirty), realiza su propia inicialización alrededor de la llamada a DoFieldExchange.
¿Cómo funciona?
No necesita comprender lo siguiente para utilizar el intercambio de campos.Sin embargo, entender el funcionamiento de ésta en segundo plano le ayudará a escribir su propio procedimiento de intercambio.
La función miembro de DoFieldExchange es como la función miembro de Serialize — es responsable de obtener o establecer datos a y desde un formulario externo (en este caso columnas de resultados de una consulta de ODBC) from/to datos de miembros en la clase.El parámetro de pFX es el contexto para hacer de intercambio y es similar al parámetro de CArchive a CObject::Serialize.pFX (un objeto de CFieldExchange ) tiene un indicador de la operación, el cual es similar, sólo una generalización de indicador de la dirección de CArchive .Una función RFX puede tener que admitir las operaciones siguientes:
BindParam — Indicate donde ODBC debe recuperar los datos de parámetro
BindFieldToColumn — Indicate donde ODBC debe recuperar o los datos de outputColumn de depósito
Fixup — longitudes concretas de CString/CByteArray , establezca el bit de estado NULL
MarkForAddNew — marca modificada si el valor ha cambiado desde llamada a AddNew
MarkForUpdate — marca modificada si el valor ha cambiado desde llamada de edición
Nombre — Agregue los nombres de campo para los campos marcó modificado
NameValue — anexe “<nombre de columna>=?” para modificado como campos
Valor — Anexe “?” seguido de separador, como “,” o ''
SetFieldDirty — bit determinado de estado modificado (es decir.) campo modificado
SetFieldNull — bit determinado de estado que indica el valor NULL para el campo
IsFieldDirty — valor devuelto de bits modificado de estado
IsFieldNull — valor devuelto de bits null de estado
IsFieldNullable — TRUE return si el campo puede contener valores nulos
StoreField (valor de campo del archivo
LoadField (valor de campo almacenado recarga
GetFieldInfoValue — información general return en un campo
GetFieldInfoOrdinal — información general return en un campo
Extensiones de usuario
Hay varias maneras de extender el mecanismo predeterminado RFX.Se puede
Agregue nuevos tipos de datos.Por ejemplo:
CBookmarkAgregue nuevos procedimientos de intercambio (RFX_???).
void AFXAPI RFX_Bigint(CFieldExchange* pFX, const char *szName, BIGINT& value);Tiene las llamadas de inclusión adicionales RFX de funciones miembro de DoFieldExchange condicional o cualquier otra instrucción válida de C++.
while (posExtraFields != NULL) { RFX_Text(pFX, m_listName.GetNext(posExtraFields), m_listValue.GetNext(posExtraValues)); }
[!NOTA]
Este código no se puede editar por ClassWizard y solo se debería usar fuera de los comentarios especiales de formato.
Escribir una personalizada RFX
Para escribir su propia función personalizados de RFX, se sugiere que copia una función existente RFX y la modifica sus propios fines.La selección de la derecha RFX de copiar puede crear el trabajo mucho más fácil.Las funciones de algún RFX tienen algunas propiedades únicas que debe tener en cuenta al decidir cuál para copiar.
RFX_Long and RFX_Int:
Estas son las funciones más simples de RFX.El valor de los datos no necesita ninguna interpretación especial, y se corrige el tamaño de datos.RFX_Single and RFX_Double:
Como RFX_Long y RFX_Int anterior, estas funciones son simples y pueden utilizar la implementación predeterminada ampliamente.Se almacenan en dbflt.cpp en lugar de dbrfx.cpp, sin embargo, para habilitar cargar la biblioteca de punto flotante en tiempo de ejecución si son explícitamente referencia.RFX_Text and RFX_Binary:
Estas dos funciones reserva un buffer estático para contener la cadena/información binaria, y deben registrar estos búferes con ODBC SQLBindCol en lugar de registrar el &value.Debido a esto, estas dos funciones tienen partes de código de especial-caso.RFX_Date:
ODBC devuelve información de fecha y hora en su propia estructura de datos de TIMESTAMP_STRUCT.Esta función asigna dinámicamente un TIMESTAMP_STRUCT como “proxy” para enviar y recibir datos de fecha y hora.Varias operaciones deben transferir información de fecha y hora entre el objeto C++ CTime y el proxy de TIMESTAMP_STRUCT.Esto complica esta función considerablemente, pero es un buen ejemplo de cómo utilizar un proxy para la transferencia de datos.RFX_LongBinary:
Esta es la única función de biblioteca de clases RFX que no utiliza el enlace de columna para recibir y enviar datos.Esta función omite la operación de BindFieldToColumn y en su lugar, durante la operación de la corrección, asigna almacenamiento para contener los datos de entrada de SQL_LONGVARCHAR o de SQL_LONGVARBINARY, realice una llamada a SQLGetData para recuperar el valor en el almacenamiento asignado.Al prepararse para exponer valores de los datos al origen de datos (como operaciones de NameValue y valor), esta función usa la funcionalidad de DATA_AT_EXEC de ODBC.Vea nota técnica 45 para obtener más información sobre cómo trabajar con SQL_LONGVARBINARY y SQL_LONGVARCHARs.
Al escribir su propia función de RFX_ , podrá a menudo utilizar CFieldExchange::Default para implementar una operación determinada.Busque la implementación predeterminado para la operación en cuestión.Si realiza la operación se estaría escribiendo en la función de RFX_ que puede delegar a CFieldExchange::Default. Puede ver ejemplos de llamar a CFieldExchange::Default en dbrfx.cpp
Es importante llamar a IsFieldType al inicio de la función RFX, y devuelve un valor inmediatamente si devuelve FALSE.Este mecanismo conserva operaciones de parámetro de realizar en outputColumns, y viceversa (como llamar a BindParam en outputColumn).Además, IsFieldType automáticamente el seguimiento del número de outputColumns (m_nFields) y params (m_nParams).