Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés
Se recomienda usar Visual Studio 2017
Esta documentación está archivada y no tiene mantenimiento.

TN053: rutinas personalizadas de DFX para DAO Database Classes

Nota Nota

A partir de Visual C++ .NET, el entorno y los asistentes de Visual C++ ya no admiten DAO (aunque las clases DAO están incluidas y todavía puede utilizarlas). Microsoft recomienda utilizar Plantillas OLE DB o ODBC y MFC para nuevos proyectos. Sólo debería utilizar DAO para mantener las aplicaciones existentes.

Esta nota técnica describe el mecanismo de intercambio de campos del registro de DAO (DFX). Para ayudar a entender lo que está pasando en rutinas de DFX, la función de DFX_Text se explicará en detalle como ejemplo. Como origen de información adicional a esta nota técnica, puede examinar el código para el otro funciones individuales DFX. No es probable que necesite una rutina de custom DFX tan a menudo como podría necesitar una rutina de custom RFX (utilizada con las clases de base de datos ODBC).

Esta nota técnica contiene:

Información general sobre DFX

El mecanismo de intercambio de campos del registro de DAO (DFX) se utiliza para simplificar el procedimiento de recuperar y actualizar datos de utilizando la clase de CDaoRecordset . El proceso se ha simplificado mediante los miembros de datos de clase de CDaoRecordset . Derivando de CDaoRecordset, puede agregar los miembros de datos a la clase derivada que representa cada campo en una tabla o una consulta. Este mecanismo “enlace estático” es simple, pero no puede ser la búsqueda de los datos y el método update de opción para todas las aplicaciones. DFX recupera cada campo enlazado cada vez que se modifica el registro actual. Si está desarrollando una aplicación en el que el rendimiento es fundamental que no requiere capturar cada campo cuando se cambia la divisa, “enlace dinámico” mediante CDaoRecordset::GetFieldValue y CDaoRecordset::SetFieldValue pueden ser el método de opción.

Nota Nota

DFX y el enlace dinámico no son mutuamente excluyentes, por lo que un uso híbrido de static y el enlace dinámico se pueden utilizar.

Ejemplo 1 - uso de intercambio del registro de DAO sólo

(supone CDaoRecordset — clase derivada CMySet abierto)

// Add a new record to the customers table
myset.AddNew();
myset.m_strCustID = _T("MSFT");
myset.m_strCustName = _T("Microsoft");
myset.Update();

Ejemplo 2 - uso de enlaces dinámicos sólo

(supone mediante la clase de CDaoRecordset , rs, ya está abierto)

// Add a new record to the customers table
COleVariant  varFieldValue1 ( _T("MSFT"), VT_BSTRT );
//Note: VT_BSTRT flags string type as ANSI, instead of UNICODE default
COleVariant  varFieldValue2  (_T("Microsoft"), VT_BSTRT );
rs.AddNew();
rs.SetFieldValue(_T("Customer_ID"), varFieldValue1);
rs.SetFieldValue(_T("Customer_Name"), varFieldValue2);
rs.Update();

Ejemplo 3 - uso de intercambio del registro de DAO y el enlace dinámico

(supone examinar los datos con CDaoRecordset- clase derivada empemployee)

// Get the employee's data so that it can be displayed
emp.MoveNext();

// If user wants to see employee's photograph,
// fetch it
COleVariant varPhoto;
if (bSeePicture)
   emp.GetFieldValue(_T("photo"), varPhoto);

// Display the data
PopUpEmployeeData(emp.m_strFirstName,
    emp.m_strLastName, varPhoto);

Cómo funciona DFX

El mecanismo de DFX funciona de forma similar al mecanismo de intercambio de campos de registros (RFX) utilizado por las clases ODBC de MFC. Los principios de DFX y RFX son iguales pero hay diferencias internas numerosas. El diseño de las funciones de DFX era tal que virtualmente todo el código es compartido por las rutinas individuales DFX. En el DFX de nivel superior hace sólo algunas cosas.

  • DFX construye la cláusula SQL SELECCIONAR y la cláusula SQL PARÁMETROS en caso necesario.

  • DFX crea la estructura de enlace utilizada por la función de GetRows DAO (más en esto más adelante).

  • DFX administra el búfer de datos utilizado para detectar campos modificados (si se utiliza el búfer doble)

  • DFX administra las matrices de estado de NULL y de DIRTY y establece valores en caso necesario en actualizaciones.

En el núcleo del mecanismo de DFX es la función de DoFieldExchange de la clase derivada de CDaoRecordset . Esta función envía llamadas a funciones individuales DFX de un tipo adecuado de la operación. Antes de llamar a DoFieldExchange las funciones internas de MFC establezca el tipo de la operación. La lista siguiente muestra los diferentes tipos de la operación y una breve descripción.

Operación

Descripción

AddToParameterList

Cláusula de los PARÁMETROS de compilaciones

AddToSelectList

Las compilaciones SELECT la cláusula

BindField

Configura la estructura de enlace

BindParam

Establece los valores de parámetro

Corrección

Establece el estado NULL

AllocCache

Asigna la memoria caché para su comprobación modificada

StoreField

Guarda el registro actual en caché

LoadField

Restaura caché a los valores de miembro

FreeCache

Libera memoria caché

SetFieldNull

Estado y valor del campo de conjuntos en NULL

MarkForAddNew

Marca los campos si no PSEUDO modificado NULL

MarkForEdit

Marca los campos modificados si no coincide con la caché

SetDirtyField

Establece los valores de campo marcados como modificados

En la sección siguiente, cada operación se explicará más detalladamente para DFX_Text.

La característica más importante para entender el proceso de intercambio de campos del registro de DAO es que utiliza la función de GetRows del objeto de CDaoRecordset . La función de DAO GetRows puede ser de varias maneras. Esta nota técnica sólo describirá brevemente GetRows como está fuera del ámbito de esta nota técnica.

DAO GetRows puede ser de varias maneras.

  • Puede capturar varios registros y varios campos de datos al mismo tiempo. Esto permite un acceso a datos más rápido con la complicación de tratar con una estructura de datos grande y los desplazamientos correspondientes a cada campo y cada registro de datos en la estructura. MFC no aprovecha este mecanismo de captura de registro múltiple.

  • Otra manera en que GetRows puede trabajar es permitir que los desarrolladores especifican direcciones de enlace para los datos recuperados de cada campo de un registro de datos.

  • DAO quiere también la “de nuevo la llamada” en el llamador para las columnas de longitud variable para permitir que el llamador asignar memoria. Esta segunda característica tiene la ventaja de minimizar el número de copias de datos así como para permitir el almacenamiento directo de datos en los miembros de una clase (la clase derivada de CDaoRecordset ). El segundo mecanismo es el método MFC utiliza para enlazar a los miembros de datos en las clases derivadas de CDaoRecordset .

Resulta evidente de análisis que la operación más importante implementada en cualquier función de DFX debe ser la capacidad de configurar las estructuras de datos necesarias para llamar correctamente GetRows. Hay otras operaciones que una función de DFX debe admitir también, pero ninguna tan importante o complejas como correctamente preparándose para la llamada de GetRows .

El uso de DFX se describe en la documentación en línea. Esencialmente, hay dos requisitos. Primero, los miembros se deben agregar a la clase derivada de CDaoRecordset para cada campo y parámetros enlazados. Después de este CDaoRecordset::DoFieldExchange debe reemplazarse. Observe que el tipo de datos de miembro es importante. Debe coincidir con los datos del campo en la base de datos o al menos ser convertible a ese tipo. Por ejemplo un campo numérico en base de datos, como un entero largo, se puede convertir siempre al texto y limitar un miembro de CString , pero un campo de texto en una base de datos no se puede convertir necesariamente con una representación numérica, como integer y límite largos a un miembro entero largo. DAO y el motor de base de datos Microsoft Jet son responsables de conversión (en lugar de MFC).

Como se ha mencionado previamente, la mejor manera de explicar cómo funciona DFX es ejecutar un ejemplo. Con este fin el pasar con los elementos internos quedan ocultos de DFX_Text debe funcionar bien para ayudar a proporcionar al menos un conocimiento básico de DFX.

AddToParameterList

Esta operación compila la cláusula SQL PARÁMETROS (“Parameters <param name>, <param type> ... ;") necesaria para Jet. Se denomina y se escribe cada parámetro (como se especifica en la llamada RFX). Vea la función de CDaoFieldExchange::AppendParamType de función para ver los nombres de los tipos individuales. En el caso de DFX_Text, el tipo utilizado es text.

AddToSelectList

Compila la cláusula SQL SELECCIONAR . Esto es bastante sencillo como el nombre de columna especificado por la llamada de DFX se anexa simplemente (“SELECT <column name>, ...").

BindField

El más complejo de operaciones. Como se mencionó anteriormente es donde configuración la estructura de enlace DAO utilizada por GetRows . Como puede ver en DFX_Text los tipos de información de la estructura el tipo DAO utilizado (DAO_CHAR o DAO_WCHAR en el caso de DFX_Text). Además, el tipo de enlace utilizado es también de instalación. En una sección anterior GetRows se describe sólo brevemente, pero era suficiente explicar que el tipo de enlace utilizado por MFC siempre es enlace directa (DAOBINDING_DIRECT). Además del enlace de longitud variable de devolución de llamada del enlace de columna (como DFX_Text) se utiliza de forma que MFC puede controlar la asignación de memoria y especificar una dirección de longitud correcta. Esto significa es el MFC puede indicar siempre DAO “where” colocar los datos, por lo que se pueden enlazar directamente a las variables miembro. El resto de la estructura de enlace se completa con tareas como la dirección de la función de devolución de llamada de asignación de memoria y el tipo de enlace de la columna (enlaces por columna nombre).

BindParam

Ésta es una operación sencilla que llama a SetParamValue con el valor de parámetro especificado en el miembro del parámetro.

Fixup

Completa el estado de NULL para cada campo.

SetFieldNull

Esta operación marca sólo cada estado del campo como NULL y establece el valor de una variable miembro a PSEUDO_NULL.

SetDirtyField

Llama a SetFieldValue para cada modificado como campo.

Todas las operaciones restantes tratan sólo de la caché de datos. La caché de datos es un búfer adicional de los datos en el registro actual que se utiliza para crear algunas cosas más sencillas. Por ejemplo, los campos “modificados” automáticamente pueden ser detectados. Como se describe en la documentación en línea puede desactivar completamente o en el del terreno. La implementación de búfer utiliza un mapa. Esta asignación se utiliza para comparar en las copias asignadas dinámicamente de datos con la dirección de campo “enlazado” (o el miembro derivado de los datos de CDaoRecordset ).

AllocCache

Asigna dinámicamente el valor de campo en caché y lo agrega al mapa.

FreeCache

Elimina el valor de campo almacenado en caché y lo quita del mapa.

StoreField

Copia el valor de campo actual en la caché de datos.

LoadField

Copia el valor almacenado en memoria caché en el miembro de campo.

MarkForAddNew

Comprueba si el valor de campo actual esNULL no y lo marca modificado en caso necesario.

MarkForEdit

El valor de campo actual con la caché de datos y marca modificado en caso necesario.

Sugerencia Sugerencia

Modele rutinas de custom DFX en rutinas existentes de DFX para los tipos de datos estándar.

Mostrar: