Compartir a través de


CDaoRecordset Class

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.

Jerarquía de herencia

CObject

CDaoRecordset

Requisitos

encabezado: afxdao.h

Vea también

Referencia

CObject (Clase)

Gráfico de jerarquías

CDaoTableDef Class

CDaoWorkspace Class

CDaoDatabase Class

CDaoQueryDef Class