virtual BOOL Requery ( );
tirar ( CDBException, CMemoryException );
Valor devuelto
Distinto de cero si el conjunto de registros fue reconstruido con éxito; caso contrario 0.
Observaciones
Llamar a esta función miembro para reconstruir (actualizar) un conjunto de registros. Si se devuelven todos los registros, el primer registro se convierte en el registro actual.
Para que el conjunto de registros reflejar las adiciones y supresiones que usted u otros usuarios están haciendo al origen de datos, debe reconstruir el objeto recordset llamando Requery. Si el conjunto de registros es un dinámico, refleja automáticamente las actualizaciones que usted u otros usuarios hacen sus registros existentes (pero no adiciones). Si el objeto recordset es una instantánea, debe llamar a Requery para reflejar cambios por otros usuarios, así como adiciones y eliminaciones.
Para un dinámico o una instantánea, llamada Requery cualquier momento que desea reconstruir el juego de registros mediante un filtro nuevo o tipo o nuevos valores de parámetro. Definir el nuevo filtro o la propiedad sort asignando nuevos valores para m_strFilter y m_strSort antes de llamar a Requery. Establecer nuevos parámetros asignando nuevos valores a los miembros de datos de parámetro antes de llamar a Requery. Si no se modifican las cadenas de filtrar y ordenar, puede volver a utilizar la consulta, que mejora el rendimiento.
Si falla el intento de reconstruir el conjunto de registros, se cierra el objeto recordset. Antes de llamar a Requery, puede determinar si el conjunto de registros puede ser somete llamando a la función de miembro CanRestart . CanRestart no garantiza que tendrá éxito Requery.
Precaució&nnbsp; Llamar a Requery sólo después de que ha pedido abierto.
Ejemplo
Este ejemplo reconstruye un objeto recordset para aplicar un orden diferente.
/ / Ejemplo de CRecordset::Requery
CCustSet rsCustSet (&NULL);
/ / Abrir el recordset
(de rsCustSet.Open);
/ / Utilizar el conjunto de registros...
/ / Establecer el orden y consultar el conjunto de registros
rsCustSet.m_strSort = "Distrito, Last_Name";
Si (! rsCustSet.CanRestart ())
nbsp; retorno; / / No se ha podido realizar una nueva consulta
Si (! rsCustSet.Requery ())
/ / Requery error, así que tome acción
Visió&n General de CRecordset |nbsp; Miembros de clase | Diagrama de jerarquía
Vea tambié&nnbsp;CRecordset::CanRestart, CRecordset::m_strFilter, CRecordset::m_strSort