Partilhar via


Método Form.Refresh (Access)

O método Refresh atualiza imediatamente os registros na fonte do registro subjacente para um formulário ou uma folha de dados especificada para refletir as alterações que você e outros usuários fizeram aos dados em um ambiente multiusuário.

Sintaxe

expressão. Atualização

expressão Uma variável que representa um objeto Form.

Valor de retorno

Nada

Comentários

Usar o método Refresh é equivalente escolhendo Atualizar na guia Página Inicial.

O Microsoft Access atualiza registros automaticamente, com base na configuração Atualizar Intervalo na guiaAvançado da caixa de diálogo Opções de Accesso disponível ao clicar no botão do Microsoft Office, e clicar em Opções de Accesso. As fontes de dados ODBC são atualizadas com base na configuração Intervalo de Atualização do ODBC na guia Avançado da caixa de diálogo Opções do Access. Use o método Refresh para exibir as alterações feitas no conjunto atual de registros em um formulário ou folha de dados desde que a fonte de registro subjacente ao formulário ou folha de dados foi atualizada pela última vez.

Em um banco de dados do Access, o método Refresh mostra somente as alterações feitas aos registros do conjunto atual. Como o método Atualizar realmente não consulta o banco de dados, o conjunto atual não inclui registros que foram adicionados ou exclui registros que foram excluídos desde que o banco de dados foi consultado pela última vez, nem excluirá registros que não satisfazem mais os critérios da pesquisa ou filtro. Para consultar novamente o banco de dados, use o método Requery. Quando a fonte de registro de um formulário for consultada novamente, o conjunto de registros atual refletirá com precisão todos os dados da fonte do registro.

Em um projeto do Access (.adp), o método Refresh consultará novamente o banco de dados e exibirá qualquer registro novo ou alterado ou removerá os registros excluídos da tabela na qual o formulário se baseia. O formulário também será atualizado para exibir registros com base nas alterações efetuadas na propriedade Filter do formulário.

Observação

  • Com frequência, é mais rápido atualizar um formulário ou uma folha de dados do que consultá-lo novamente. Isso será especialmente verdadeiro caso a consulta inicial tenha sido executada de forma lenta.
  • Não confunda o método Refresh com o método Repaint, que pinta novamente a tela com todas as alterações visuais pendentes.

Exemplo

O exemplo a seguir usa o método Refresh para atualizar os registros na fonte do registro subjacente para o formulário Clientes sempre que o formulário receber o foco.

Private Sub Form_Activate() 
    Me.Refresh 
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.