Método SubForm.Requery (Access)

  • Artículo

El método Requery actualiza los datos subyacentes de un subformulario especificado mediante la ejecución de una nueva consulta del origen de datos del subformulario.

Sintaxis

expresión. Requery

Expresión Variable que representa un objeto SubForm .

Comentarios

Use este método para asegurarse de que un formulario o control muestra los datos más recientes.

El método Requery realiza una de estas acciones:

  • Vuelve a ejecutar la consulta en la que están basados el formulario o control.
  • Muestra los registros nuevos o modificados, o quita los registros eliminados de la tabla en la que están basados el formulario o control.
  • Actualiza los registros mostrados basándose en los cambios de la propiedad Filter del formulario.

Los controles basados en una consulta o tabla son:

  • Cuadros de lista y cuadros combinados.
  • Controles de subformulario.
  • Objetos OLE, por ejemplo, gráficos.
  • Funciones de agregado de controles cuya propiedad ControlSource incluye funciones agregadas de dominio o SQL.

Si especifica cualquier otro tipo de control para el objeto especificado por expression, se vuelve a consultar el origen de registros del formulario.

Si el objeto especificado por expression no está enlazado a un campo de una tabla o consulta, el método Requery fuerza un nuevo cálculo del control.

Si omite el objeto especificado por expresión, el método Requery realiza una nueva consulta del origen de los datos subyacentes del formulario o control que tiene el enfoque. Si el control que tiene el enfoque tiene un origen del registro u origen de la fila, se realizará una nueva consulta; de lo contrario, simplemente se actualizarán los datos del control.

Si un control de subformulario tiene el enfoque, este método sólo realiza una nueva consulta del origen de los datos del subformulario, no del formulario principal.

Nota:

  • El método Requery actualiza los datos subyacentes de un formulario o control para que reflejen los registros que se agregaron o eliminaron del origen de los registros desde la última vez que se consultó. El método Refresh solo muestra los cambios realizados en el conjunto de registros actual, no muestra los registros nuevos o eliminados en el origen de registros. El método Repaint solo vuelve a dibujar el formulario especificado y sus controles.
  • El método Requery no cede el control al sistema operativo para permitir que Windows continúe procesando mensajes. Use la función DoEvents si necesita ceder temporalmente el control al sistema operativo.
  • El método Requery es más rápido que la acción Requery. Cuando se usa la acción Requery, Microsoft Access cierra la consulta y la vuelve a cargar desde la base de datos. Cuando se usa el método Requery , Access vuelve a ejecutar la consulta sin cerrarla ni volver a cargarla.

Ejemplo:

En el ejemplo siguiente se usa el método Requery para volver a consultar los datos del cuadro de lista EmployeeList de un formulario Employees .

Public Sub RequeryList() 
 
    Dim ctlCombo As Control 
 
    ' Return Control object pointing to a combo box. 
    Set ctlCombo = Forms!Employees!ReportsTo 
 
    ' Requery source of data for list box. 
    ctlCombo.Requery 
 
End Sub

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.