Método Control. reQuery (Access)Control.Requery method (Access)

O método Requery atualiza os dados subjacentes a um controle especificado que está no formulário ativo pela repetição da consulta à fonte de dados do controle.The Requery method updates the data underlying a specified control that's on the active form by requerying the source of data for the control.

SintaxeSyntax

expressão. Repetir consultaexpression.Requery

expressão Uma variável que representa um objeto Control .expression A variable that represents a Control object.

ComentáriosRemarks

Você pode utilizar este método para garantir que um formulário ou controle exiba os dados mais recentes.You can use this method to ensure that a form or control displays the most recent data.

O método Requery procede de uma das seguintes opções:The Requery method does one of the following:

  • Executa novamente a consulta na qual o formulário ou controle é baseado.Reruns the query on which the form or control is based.
  • Exibe qualquer registro novo ou alterado, ou remove registros excluídos da tabela na qual o formulário ou controle está baseado.Displays any new or changed records or removes deleted records from the table on which the form or control is based.
  • Atualiza registros exibidos com base em qualquer alteração feita na propriedade Filter do formulário.Updates records displayed based on any changes to the Filter property of the form.

Os controles baseados em uma consulta ou tabela incluem:Controls based on a query or table include:

  • Caixas de listagem e Caixas de combinação.List boxes and combo boxes.
  • Controles de subformulário.Subform controls.
  • Objetos OLE, tais como gráficos.OLE objects, such as charts.
  • Funções agregam de controles para os quais a configuração da propriedade ControlSource inclui funções agregadas de domínio ou SQL.Controls for which the ControlSource property setting includes domain aggregate functions or SQL aggregate functions.

Se você especificar qualquer outro tipo de controle para o objeto especificado pela expressão, a fonte de registro do formulário será repetida.If you specify any other type of control for the object specified by expression, the record source for the form is requeried.

Se o objeto especificado pela expressão não estiver acoplado a um campo em uma tabela ou consulta **** , o método Requery forçará um recálculo do controle.If the object specified by expression isn't bound to a field in a table or query, the Requery method forces a recalculation of the control.

Se você omitir o objeto especificado pela expressão, o método Requery consulta a fonte de dados subjacente para o formulário ou controle que tem o foco. ****If you omit the object specified by expression, the Requery method requeries the underlying data source for the form or control that has the focus. Se o controle que tem o foco tiver uma fonte de registro ou fonte de linha, a consulta será repetida; Caso contrário, os dados do controle serão simplesmente atualizados.If the control that has the focus has a record source or row source, it will be requeried; otherwise, the control's data will simply be refreshed.

Se um controle subformulário tiver o foco, esse método repete somente a consulta à fonte de registro para o subformulário, não para o formulário pai.If a subform control has the focus, this method only requeries the record source for the subform, not the parent form.

Observação

  • [!OBSERVAçãO] O método Requery atualiza os dados base de um formulário ou controle para refletir registros que são novos no ou excluídos da fonte do registro desde a última consulta.The Requery method updates the data underlying a form or control to reflect records that are new to or deleted from the record source since it was last queried. O método Refresh mostra somente as alterações que tenham sido feitas no conjunto atual de registros; ele não reflete registros novos ou excluídos na fonte do registro.The Refresh method shows only changes that have been made to the current set of records; it doesn't reflect new or deleted records in the record source. O **** método Repaint simplesmente pinta novamente o formulário especificado e seus controles.The Repaint method simply repaints the specified form and its controls.
  • O método Requery não passa o controle para o sistema operacional para permitir que o Windows continue o processamento de mensagens.The Requery method doesn't pass control to the operating system to allow Windows to continue processing messages. Use a função DoEvents se precisar liberar o controle temporário para o sistema operacional.Use the DoEvents function if you need to relinquish temporary control to the operating system.
  • O método Requery é mais rápido do que a ação Requery.The Requery method is faster than the Requery action. Quando você usa a ação Requery, o Microsoft Access fecha a consulta e a recarrega do banco de dados.When you use the Requery action, Microsoft Access closes the query and reloads it from the database. Quando você usa o **** método Requery, o Access executa novamente a consulta sem fechá-la e recarregá-la.When you use the Requery method, Access reruns the query without closing and reloading it.

ExemploExample

O exemplo a seguir usa **** o método Requery para repetir a consulta dos dados da caixa de listagem employeeList em um formulário Employees .The following example uses the Requery method to requery the data from the EmployeeList list box on an Employees form.

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

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.