Compartir a través de


CRecordset Class

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

class CRecordset : public CObject

Miembros

Constructores públicos

Name

Descripción

CRecordset::CRecordset

Crea un objeto CRecordset. La clase derivada debe proporcionar un constructor que llame a éste.

Métodos públicos

Name

Descripción

CRecordset::AddNew

Se prepara para agregar un nuevo registro. Llamada Update para completar la suma.

CRecordset::CanAppend

Devuelve cero si los nuevos registros se pueden agregar al conjunto de registros mediante la función miembro de AddNew .

CRecordset::CanBookmark

Devuelve cero si el conjunto de registros admite marcadores.

CRecordset::Cancel

Cancela una operación asincrónica o un proceso de segundo subproceso.

CRecordset::CancelUpdate

cancela cualquier actualización pendiente debido a una operación de AddNew o de Edit .

CRecordset::CanRestart

Devuelve cero si Requery se puede llamar a para ejecutar la consulta de conjunto de registros de nuevo.

CRecordset::CanScroll

Devuelve cero si puede desplazarse por los registros.

CRecordset::CanTransact

Devuelve cero si el origen de datos admite transacciones.

CRecordset::CanUpdate

Devuelve cero si el conjunto de registros se puede actualizar (puede agregar, actualizar, o eliminar registros).

CRecordset::CheckRowsetError

Denominado para controlar los errores generados durante la obtención de registro.

CRecordset::Close

Cierre el conjunto de registros y ODBC HSTMT asociado.

CRecordset::Delete

Elimina el registro actual del conjunto de registros. Debe explícitamente desplazarse a otro registro después de la eliminación.

CRecordset::DoBulkFieldExchange

Denominado para cambiar filas masivas de datos desde el origen de datos al conjunto de registros. Implementa el intercambio masivo de campos de registros (RFX Masivo).

CRecordset::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. Implementa el intercambio masivo de campos de registros.

CRecordset::Edit

Se prepara para los cambios del registro actual. Llame a Update para finalizar la edición.

CRecordset::FlushResultSet

Devuelve cero si hay otro conjunto de resultados que se recupere, al usar una consulta predefinida.

CRecordset::GetBookmark

Asigna el valor del marcador de un registro al objeto de parámetro.

CRecordset::GetDefaultConnect

denominado para obtener la cadena de conexión predeterminada.

CRecordset::GetDefaultSQL

Denominado para obtener la cadena SQL predeterminada para ejecutarse.

CRecordset::GetFieldValue

Devuelve el valor de un campo de un conjunto de registros.

CRecordset::GetODBCFieldCount

Devuelve el número de campos del conjunto de registros.

CRecordset::GetODBCFieldInfo

Devuelve los tipos de información concreta sobre los campos de un conjunto de registros.

CRecordset::GetRecordCount

Devuelve el número de registros del conjunto de registros.

CRecordset::GetRowsetSize

Devuelve el número de registros que desea en la recuperación durante una sola búsqueda.

CRecordset::GetRowsFetched

devuelve el número de filas real recuperadas durante una búsqueda.

CRecordset::GetRowStatus

Devuelve el estado de fila después de una búsqueda.

CRecordset::GetSQL

Obtiene la cadena SQL utilizada para seleccionar registros del conjunto de registros.

CRecordset::GetStatus

Obtiene el estado del conjunto de registros: el índice del registro actual y si un recuento final de registros se ha obtenido.

CRecordset::GetTableName

Obtiene el nombre de la tabla en la que se basa el conjunto de registros.

CRecordset::IsBOF

Devuelve cero si se ha colocado el conjunto de registros antes del primer registro. No hay ningún registro actual.

CRecordset::IsDeleted

Devuelve cero si colocan el conjunto de registros en un registro eliminado.

CRecordset::IsEOF

Devuelve cero si se ha colocado el conjunto de registros después del último registro. No hay ningún registro actual.

CRecordset::IsFieldDirty

Devuelve cero si el campo especificado en el registro actual se ha cambiado.

CRecordset::IsFieldNull

Devuelve cero si el campo especificado en el registro actual es null (no tiene ningún valor.

CRecordset::IsFieldNullable

Devuelve cero si el campo especificado en el registro actual se puede establecer en null (no tener ningún valor).

CRecordset::IsOpen

Devuelve cero si Open se ha llamado previamente.

CRecordset::Move

Coloca el conjunto de registros en un número de registros especificado del registro actual en cualquier dirección.

CRecordset::MoveFirst

Coloca el registro actual respecto al primer registro del conjunto de registros. prueba para IsBOF primero.

CRecordset::MoveLast

Coloca el registro actual respecto al último registro o respecto al último conjunto de filas. prueba para IsEOF primero.

CRecordset::MoveNext

Coloca el registro actual respecto al registro siguiente o respecto al siguiente conjunto de filas. prueba para IsEOF primero.

CRecordset::MovePrev

Coloca el registro actual respecto al registro anterior o respecto al conjunto de filas anterior. prueba para IsBOF primero.

CRecordset::OnSetOptions

Denominado para establecer opciones (utilizadas en la selección) para la instrucción especificada de ODBC.

CRecordset::OnSetUpdateOptions

Denominado para establecer opciones (utilizadas en actualización) para la instrucción especificada de ODBC.

CRecordset::Open

Abra el conjunto de registros recuperando la tabla o realizando la consulta que el conjunto de registros representa.

CRecordset::RefreshRowset

actualiza los datos y el estado de las filas especificadas.

CRecordset::Requery

Ejecuta la consulta de conjunto de registros de nuevo para actualizar los registros seleccionados.

CRecordset::SetAbsolutePosition

Coloca el conjunto de registros respecto al registro correspondiente al número de registro especificado.

CRecordset::SetBookmark

Coloca el conjunto de registros respecto al registro especificado por el marcador.

CRecordset::SetFieldDirty

Marca el campo especificado en el registro actual como cambiado.

CRecordset::SetFieldNull

Establece el valor del campo especificado en el registro actual en null (no tener ningún valor).

CRecordset::SetLockingMode

Establece bloquear “optimista” del modo de bloqueo (valor predeterminado) o bloquear “pesimista”. determina cómo los registros están bloqueados para las actualizaciones.

CRecordset::SetParamNull

Establece el parámetro especificado en null (no tener ningún valor).

CRecordset::SetRowsetCursorPosition

Coloca el cursor respecto a la fila especificada dentro del conjunto de filas.

CRecordset::SetRowsetSize

Especifica el número de registros que desea en la recuperación durante una búsqueda.

CRecordset::Update

Completa una operación de AddNew o de Edit guardar nuevos o editar datos en el origen de datos.

Miembros de datos públicos

Name

Descripción

CRecordset::m_hstmt

contiene el identificador de instrucciones de ODBC para el conjunto de registros. Escriba HSTMT.

CRecordset::m_nFields

Contiene el número de miembros de datos de campo del conjunto de registros. Escriba UINT.

CRecordset::m_nParams

Contiene el número de miembros de datos de parámetro en el conjunto de registros. Escriba UINT.

CRecordset::m_pDatabase

Contiene un puntero al objeto de CDatabase a través del que el conjunto de registros está conectado con un origen de datos.

CRecordset::m_strFilter

Contiene CString que especifica una cláusula (SQL) de WHERE de lenguaje de consulta estructurado. Se utiliza como filtro para seleccionar sólo los registros que cumplen ciertos criterios.

CRecordset::m_strSort

Contiene CString que especifica una cláusula SQL ORDER BY . Utilizado para controlar cómo se ordenan los registros.

Comentarios

Conocido como “conjuntos de registros”, los objetos de CRecordset se utilizan normalmente en dos formas: conjuntos de registros dinámicos e instantáneas. Un conjunto permanece sincronizado con las actualizaciones de datos creadas por otros usuarios. una instantánea es una vista estática de los datos. Cada formulario representa un conjunto de registros corregidos cuando abre el conjunto de registros, pero cuando se desplace a un registro en un conjunto, refleja los cambios realizados posteriormente en el registro, por otros usuarios o por otros conjuntos de registros de la aplicación.

NotaNota

Si trabaja con las clases (DAO) de Objetos de acceso a datos en lugar de las clases de ODBC, utilice la clase CDaoRecordset en su lugar.Para obtener más información, vea el artículo información general: programación de la base de datos.

Para trabajar con cualquier tipo de conjunto de registros, se deriva normalmente una clase específica de la aplicación de conjunto de registros CRecordset. Se seleccionan los registros de un origen de datos, y a continuación:

  • Desplácese por los registros.

  • Actualizar registros y especifique un modo de bloqueo.

  • 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.

Para utilizar la clase, abra una base de datos y crear un objeto de conjunto de registros, pasando al constructor un puntero al objeto de CDatabase . Llamar a continuación a la función miembro de Abrir de conjunto de registros, donde puede especificar si el objeto es de tipo dinámico o una instantánea. La llamada Abrir selecciona los datos del origen de datos. Después de abrir el objeto de conjunto de registros, utilice las funciones y miembros de datos de miembro para desplazarse por los registros y para operarlos en. Las operaciones disponibles dependen de si el objeto es de tipo dinámico o una instantánea, si es actualizable o de sólo lectura (éste depende de la capacidad del origen de datos de ODBC), y si está implementada la obtención masiva de filas. 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.

En una clase derivada de CRecordset , el intercambio masivo de campos de registro o el intercambio masivo de campos de registros (RFX Masivo) se utiliza para admitir la lectura y actualización de campos de registros.

Para obtener más información sobre conjuntos de registros y el intercambio de campos, vea los artículos información general: programación de la base de datos, conjunto de registros (ODBC), conjunto de registros: Obtener registros de forma masiva (ODBC), y Intercambio de campos de registros. Para un enfoque en conjuntos de registros dinámicos e instantáneas, vea los artículos Dinámico y Instantánea.

Jerarquía de herencia

CObject

CRecordset

Requisitos

encabezado: afxdb.h

Vea también

Referencia

CObject Class

Gráfico de jerarquías

CDatabase (Clase)

CRecordView Class