Método NavigationButton.Requery (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.

Sintaxe

expressão. Repetirconsulta

Expressão Uma variável que representa um objeto NavigationButton .

Comentários

Use esse método para garantir que um formulário ou controle exiba os dados mais recentes.

O método Requery procede de uma das seguintes opções:

• Executa novamente a consulta na qual o formulário ou controle é baseado.
• Exibe qualquer registro novo ou alterado, ou remove registros excluídos da tabela na qual o formulário ou controle está baseado.
• Atualiza registros exibidos com base em qualquer alteração feita na propriedade Filter do formulário.

Os controles baseados em uma consulta ou tabela incluem:

• Caixas de listagem e Caixas de combinação.
• Controles de subformulário.
• Objetos OLE, tais como gráficos.
• Funções agregam de controles para os quais a configuração da propriedade ControlSource inclui funções agregadas de domínio ou SQL.

Se você especificar qualquer outro tipo de controle para o objeto especificado pela expressão, a fonte de registro do formulário será requerida.

Se o objeto especificado pela expressão não estiver associado a um campo em uma tabela ou consulta, o método Requery força um recálculo do controle.

Se você omitir o objeto especificado pela expressão, o método Requery requer a fonte de dados subjacente para o formulário ou controle que tem o foco. 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.

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.

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. 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. O método Repaint simplesmente repinta o formulário especificado e seus controles.
• O método Requery não passa o controle para o sistema operacional para permitir que o Windows continue o processamento de mensagens. Use a função DoEvents se precisar liberar o controle temporário para o sistema operacional.
• O método Requery é mais rápido do que a ação Requery. Quando você usa a ação Requery, o Microsoft Access fecha a consulta e a recarrega do banco de dados. Quando você usa o método Requery , o Access executa novamente a consulta sem fechá-la e recarregá-la.

Exemplo

O exemplo a seguir usa o método Requery para requerer os dados da caixa de lista EmployeeList em um formulário 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

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? 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.