Método Page.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.
expressão. Repetirconsulta
Expressão Uma variável que representa um objeto Page .
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.
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
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.