Clase CDaoRecordset

Artículo
04/10/2013

Representa un conjunto de registros seleccionados de un origen de datos.

class CDaoRecordset : public CObject

Members

Constructores públicos

Name	Descripción
CDaoRecordset::CDaoRecordset	Crea un objeto CDaoRecordset.

Métodos públicos

Name	Descripción
CDaoRecordset::AddNew	Se prepara para agregar un nuevo registro.Llamada Actualizar para completar la suma.
CDaoRecordset::CanAppend	Devuelve cero si los nuevos registros se pueden agregar al conjunto de registros mediante la función miembro de AddNew .
CDaoRecordset::CanBookmark	Devuelve cero si el conjunto de registros admite marcadores.
CDaoRecordset::CancelUpdate	Cancela cualquier actualización pendiente debido a una operación de Editar o de AddNew .
CDaoRecordset::CanRestart	Devuelve cero si Requery se puede llamar a para ejecutar la consulta de conjunto de registros de nuevo.
CDaoRecordset::CanScroll	Devuelve cero si puede desplazarse por los registros.
CDaoRecordset::CanTransact	Devuelve cero si el origen de datos admite transacciones.
CDaoRecordset::CanUpdate	Devuelve cero si el conjunto de registros se puede actualizar (puede agregar, actualizar, o eliminar registros).
CDaoRecordset::Close	Cierre el conjunto de registros.
CDaoRecordset::Delete	Elimina el registro actual del conjunto de registros.Debe explícitamente desplazarse a otro registro después de la eliminación.
CDaoRecordset::DoFieldExchange	Denominado para intercambiar los datos (en ambas direcciones) entre los miembros de datos de campo de conjunto de registros y el registro correspondiente en el origen de datos.Intercambio de campos del registro de DAO de instrumenta (DFX).
CDaoRecordset::Edit	Se prepara para los cambios del registro actual.Llamada Actualizar para finalizar la edición.
CDaoRecordset::FillCache	Rellena la totalidad o una parte caché local para un objeto de conjunto de registros que contenga datos de un origen de datos ODBC.
CDaoRecordset::Find	Busque la primera, siguiente, anterior, o a la última ubicación de una cadena concreta en un conjunto de registros de dynaset- tipo que cumpla los criterios especificados y la crea que registra el registro actual.
CDaoRecordset::FindFirst	Buscar el primer registro en un conjunto de registros de dynaset- tipo o de instantánea- tipo que cumpla los criterios especificados y hace que registra el registro actual.
CDaoRecordset::FindLast	Busque el último registro en un conjunto de registros de dynaset- tipo o de instantánea- tipo que cumpla los criterios especificados y hace que registra el registro actual.
CDaoRecordset::FindNext	Busque el registro siguiente en un conjunto de registros de dynaset- tipo o de instantánea- tipo que cumpla los criterios especificados y hace que registra el registro actual.
CDaoRecordset::FindPrev	Busque el registro anterior en un conjunto de registros de dynaset- tipo o de instantánea- tipo que cumpla los criterios especificados y hace que registra el registro actual.
CDaoRecordset::GetAbsolutePosition	Devuelve el número de registro del registro actual de un objeto de conjunto de registros.
CDaoRecordset::GetBookmark	Devuelve un valor que representa el marcador en un registro.
CDaoRecordset::GetCacheSize	Devuelve un valor que especifica el número de registros de un conjunto de registros de dynaset- tipo que contiene los datos localmente que se va a almacenar en memoria caché de un origen de datos ODBC.
CDaoRecordset::GetCacheStart	Devuelve un valor que especifica el marcador del primer registro del conjunto de registros que se almacene en memoria caché.
CDaoRecordset::GetCurrentIndex	Devuelve CString que contiene el nombre del índice utilizado recientemente en un indizado, tabla- tipo CDaoRecordset.
CDaoRecordset::GetDateCreated	Devuelve la fecha y hora en que la tabla base que era la base de un objeto de CDaoRecordset se creó
CDaoRecordset::GetDateLastUpdated	Devuelve la fecha y hora de cambio realizado más reciente en el diseño de una tabla base subyacente de un objeto de CDaoRecordset .
CDaoRecordset::GetDefaultDBName	Devuelve el nombre del origen de datos predeterminado.
CDaoRecordset::GetDefaultSQL	Denominado para obtener la cadena SQL predeterminada para ejecutarse.
CDaoRecordset::GetEditMode	Devuelve un valor que indica el estado de edición del registro actual.
CDaoRecordset::GetFieldCount	Devuelve un valor que representa el número de campos en un conjunto de registros.
CDaoRecordset::GetFieldInfo	Devuelve los tipos de información concreta sobre los campos en el conjunto de registros.
CDaoRecordset::GetFieldValue	Devuelve el valor de un campo de un conjunto de registros.
CDaoRecordset::GetIndexCount	Recupera el número de índices en una tabla subyacente de un conjunto de registros.
CDaoRecordset::GetIndexInfo	Devuelve a distintos tipos de información sobre un índice.
CDaoRecordset::GetLastModifiedBookmark	Utilizado para determinar el registro recientemente agregado o actualizado.
CDaoRecordset::GetLockingMode	Devuelve un valor que indica el tipo de bloqueo que esté en efecto durante la edición.
CDaoRecordset::GetName	Devuelve CString que contiene el nombre del conjunto de registros.
CDaoRecordset::GetParamValue	Recupera el valor actual del parámetro especificado almacenado en el objeto subyacente de DAOParameter.
CDaoRecordset::GetPercentPosition	Devuelve la posición del registro actual como porcentaje del número de registros total.
CDaoRecordset::GetRecordCount	Devuelve el número de registros obtenidos en un objeto de conjunto de registros.
CDaoRecordset::GetSQL	Obtiene la cadena SQL utilizada para seleccionar registros del conjunto de registros.
CDaoRecordset::GetType	Denominado para determinar el tipo de un conjunto de registros: tabla-tipo, dynaset-tipo, o instantánea-tipo.
CDaoRecordset::GetValidationRule	Devuelve CString que contiene el valor que valida los datos a medida que se escribe en un campo.
CDaoRecordset::GetValidationText	Recupera el texto que se muestra cuando una regla de validación no se cumple.
CDaoRecordset::IsBOF	Devuelve cero si se ha colocado el conjunto de registros antes del primer registro.No hay ningún registro actual.
CDaoRecordset::IsDeleted	Devuelve cero si colocan el conjunto de registros en un registro eliminado.
CDaoRecordset::IsEOF	Devuelve cero si se ha colocado el conjunto de registros después del último registro.No hay ningún registro actual.
CDaoRecordset::IsFieldDirty	Devuelve cero si el campo especificado en el registro actual se ha cambiado.
CDaoRecordset::IsFieldNull	Devuelve cero si el campo especificado en el registro actual es Null (no tener ningún valor).
CDaoRecordset::IsFieldNullable	Devuelve cero si el campo especificado en el registro actual se puede establecer en Null (no tener ningún valor).
CDaoRecordset::IsOpen	Devuelve cero si Abrir se ha llamado previamente.
CDaoRecordset::Move	Coloca el conjunto de registros en un número de registros especificado del registro actual en cualquier dirección.
CDaoRecordset::MoveFirst	Coloca el registro actual respecto al primer registro del conjunto de registros.
CDaoRecordset::MoveLast	Coloca el registro actual en el último registro en el conjunto de registros.
CDaoRecordset::MoveNext	Coloca el registro actual en el registro siguiente en el conjunto de registros.
CDaoRecordset::MovePrev	Coloca el registro actual en el registro anterior en el conjunto de registros.
CDaoRecordset::Open	Crea un nuevo conjunto de registros de una tabla, un conjunto, o de una instantánea.
CDaoRecordset::Requery	Ejecuta la consulta de conjunto de registros de nuevo para actualizar los registros seleccionados.
CDaoRecordset::Seek	Busque el registro en un objeto de conjunto de registros indizado de tabla- tipo que cumpla los criterios especificados para el índice actual y hace que registra el registro actual.
CDaoRecordset::SetAbsolutePosition	Establece el número de registro del registro actual de un objeto de conjunto de registros.
CDaoRecordset::SetBookmark	Coloca el conjunto de registros en un registro que contiene el marcador especificado.
CDaoRecordset::SetCacheSize	Establece un valor que especifica el número de registros de un conjunto de registros de dynaset- tipo que contiene los datos localmente que se va a almacenar en memoria caché de un origen de datos ODBC.
CDaoRecordset::SetCacheStart	Establece un valor que especifica el marcador del primer registro del conjunto de registros que se almacene en memoria caché.
CDaoRecordset::SetCurrentIndex	Denominado para establecer un índice en un conjunto de registros de tabla- tipo.
CDaoRecordset::SetFieldDirty	Marca el campo especificado en el registro actual como cambiado.
CDaoRecordset::SetFieldNull	Establece el valor del campo especificado en el registro actual en Null (no tener ningún valor).
CDaoRecordset::SetFieldValue	Establece el valor de un campo de un conjunto de registros.
CDaoRecordset::SetFieldValueNull	Establece el valor de un campo de un conjunto de registros en Null.(no tener ningún valor).
CDaoRecordset::SetLockingMode	Establece un valor que indica el tipo de bloqueo para ejecutar durante la edición.
CDaoRecordset::SetParamValue	Establece el valor actual del parámetro especificado almacenado en el objeto subyacente de DAOParameter
CDaoRecordset::SetParamValueNull	Establece el valor actual del parámetro especificado en Null (no tener ningún valor).
CDaoRecordset::SetPercentPosition	Establece la posición del registro actual en una ubicación correspondiente a un porcentaje del número total de registros de un conjunto de registros.
CDaoRecordset::Update	Completa una operación de AddNew o de Editar guardar nuevos o editar datos en el origen de datos.

Miembros de datos públicos

Name	Descripción
CDaoRecordset::m_bCheckCacheForDirtyFields	Contiene una marca que indica si los campos automáticamente están marcados como cambiado.
CDaoRecordset::m_nFields	Contiene el número de miembros de datos de campo en la clase de conjunto de registros y el número de columnas seleccionadas por el conjunto de registros del origen de datos.
CDaoRecordset::m_nParams	Contiene el número de miembros de datos de parámetro en la clase de conjunto de registros (el número de parámetros pasados con la consulta de conjunto de registros
CDaoRecordset::m_pDAORecordset	Un puntero a la interfaz de DAO al objeto de conjunto de registros.
CDaoRecordset::m_pDatabase	Base de datos de origen para este conjunto de resultados.Contiene un puntero a un objeto de CDaoDatabase .
CDaoRecordset::m_strFilter	Contiene una cadena utilizada para construir un extracto de SQL WHERE .
CDaoRecordset::m_strSort	Contiene una cadena utilizada para construir un extracto de SQL ORDER BY .

Comentarios

Conocido como “conjuntos de registros”, los objetos de CDaoRecordset están disponibles en las tres formas siguientes:

Los conjuntos de registros de Tabla- tipo representa una tabla base que puede utilizar para examinar, para agregar, cambiar, o eliminar registros de una única tabla de base de datos.
Los conjuntos de registros de Dynaset- tipo son el resultado de una consulta que pueda tener registros actualizables.Estos conjuntos de registros son un conjunto de registros que puede utilizar para examinar, para agregar, cambiar, o eliminar registros de una tabla o de tablas de base de datos subyacente.Los conjuntos de registros de Dynaset- tipo pueden contener campos de una o más tablas en una base de datos.
Los conjuntos de registros de Instantánea- tipo son una copia estática de un conjunto de registros que se puede utilizar para buscar datos o para generar informes.Estos conjuntos de registros pueden contener campos de una o más tablas en una base de datos pero no pueden actualizarse.

Cada formulario de conjunto de registros representa un conjunto de registros corregidos cuando se abre el conjunto de registros.Cuando se desplace a un registro en un conjunto de registros de tabla- tipo o un conjunto de registros de dynaset- tipo, refleja los cambios realizados en el registro después de que otros conjuntos de registros en la aplicación abre el conjunto de registros, por otros usuarios o.(El conjunto de registros de instantánea- tipo de A no puede actualizarse.) Puede utilizar CDaoRecordset directamente o derivar una clase específica de la aplicación de conjunto de registros CDaoRecordset.Seguidamente puede:

Desplácese por los registros.
Establezca un índice y buscar rápidamente los registros utilizando búsqueda (conjuntos de registros de tabla- tipo sólo).
Busque los registros basándose en una comparación de cadenas: “<”, “<=”, “=”, “>=”, o “>” (conjuntos de registros de dynaset- tipo y el instantánea- tipo).
Actualizar registros y especifique un modo de bloqueo (excepto los conjuntos de registros de instantánea- tipo).
Filtre el conjunto de registros para restringir qué registros se seleccionan de los disponibles en el origen de datos.
Ordenar el conjunto de registros.
Parametrizar el conjunto de registros para personalizar la selección con información no conocida hasta el tiempo de ejecución.

Ordenar las fuentes de CDaoRecordset una interfaz similar a la de la clase CRecordset.La diferencia principal es que la clase CDaoRecordset tiene acceso a datos a través de un Objeto de acceso a datos (DAO) basado en OLE.Ordenar los métodos de CRecordset DBMS con (ODBC) y un controlador ODBC para ese DBMS.

[!NOTA]

Las clases de base de datos de DAO son distintas de las clases de base de datos MFC basadas en ODBC.Todos los nombres de clase de base de datos de DAO tienen el prefijo “CDao”.Todavía puede tener acceso a orígenes de datos ODBC con las clases DAO; las clases DAO suelen proporcionar capacidades máximas porque son específicas del motor de base de datos Microsoft Jet.

Puede utilizar CDaoRecordset directamente o derivar una clase de CDaoRecordset.Para utilizar una clase de conjunto de registros en cualquier caso, abrir una base de datos y crear un objeto de conjunto de registros, pasando al constructor un puntero al objeto de CDaoDatabase .También puede crear un objeto de CDaoRecordset y permite MFC crear un objeto temporal de CDaoDatabase automáticamente.Llamar a continuación a la función miembro de Abrir de conjunto de registros, que especifica si el objeto es un conjunto de registros de tabla- tipo, un conjunto de registros de dynaset- tipo, o un conjunto de registros de instantánea- tipo.La llamada Open selecciona los datos de la base de datos y recupera el primer registro.

Utilice las funciones y los miembros de datos de miembro de objeto desplazarse a través de los registros y operelos en.Las operaciones disponibles dependen de si el objeto es un conjunto de registros de tabla- tipo, un conjunto de registros de dynaset- tipo, o un conjunto de registros de instantánea- tipo y, si es actualizable o de sólo lectura — éste depende de la capacidad de la base de datos o el origen de datos de ODBC.Para actualizar registros que hayan sido modificados o haber sido agregados desde la llamada de Abrir , llama a la función miembro de Requery del objeto.Llame a la función miembro de Cerrar de objeto y destruya el objeto cuando acaba con él.

Intercambio de campos del registro de DAO de las aplicaciones deCDaoRecordset (DFX) para admitir la lectura y actualización de campos de registros entre los miembros tipo- seguros de C++ del CDaoRecordset o de CDaoRecordset- clase derivada.También puede implementar el enlace dinámico de columnas en una base de datos sin utilizar el mecanismo de DFX mediante GetFieldValue y SetFieldValue.

Para obtener información relacionada, vea el tema “objeto de conjunto de registros” en DAO Help.