Método DoCmd.Requery (Access)

Desempenha a ação RepetirConsulta no Visual Basic.

Sintaxe

expressão. Requery (ControlName)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Controlname	Opcional	Variant	Uma expressão de cadeia de caracteres que é o nome de um controle guia no objeto ativo.

Comentários

Use a ação Requery para atualizar os dados em um controle especificado no objeto ativo requerindo a origem do controle. Se nenhum controle for especificado, essa ação consultará novamente a fonte do próprio objeto. Use essa ação para assegurar que o objeto ativo ou um de seus controles exiba os dados mais atuais.

Se você deixar o argumento ControlName em branco, a ação Requery terá o mesmo efeito que pressionar Shift+F9 quando o objeto tiver o foco. Se um controle de subforma tiver o foco, essa ação requer apenas a origem do subforma (assim como pressionar Shift+F9 faz).

Se você deseja repetir um controle que não está no objeto ativo, você deve usar o método Requery no Visual Basic, e não a ação RepetirConsulta ou seu método Requery correspondente do objeto DoCmd. O método Requery no Visual Basic é mais rápido que a ação RepetirConsulta ou o método Requery.

Além disso, quando você usa a ação RepetirConsulta ou o método Requery, o Microsoft Access fecha a consulta e recarrega a partir do banco de dados, mas quando você usa o método Requery, o Access executa novamente a consulta sem fechá-la e recarregá-la. Observe que o método ActiveX Data Object (ADO) Requery funciona da mesma maneira que o método Requery do Access.

Exemplo

O exemplo a seguir usa o método Requery para atualizar o controle EmployeeList .

DoCmd.Requery "EmployeeList"

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.