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

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

Comentários

Utilize este método para garantir que um formulário ou controlo apresenta 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 especificar qualquer outro tipo de controlo para o objeto especificado pela expressão, a origem de registos do formulário será requerida.

Se o objeto especificado pela expressão não estiver vinculado a um campo numa tabela ou consulta, o método Requery força um recálculo do controlo.

Se omitir o objeto especificado pela expressão, o método Requery requer a origem de dados subjacente para o formulário ou controlo 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 repaint repaints o formulário especificado e os respetivos controlos.
• 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 utiliza o método Requery , o Access executará novamente a consulta sem a fechar e recarregar.

Exemplo

O exemplo seguinte utiliza o método Requery para requerer os dados da caixa de listagem EmployeeList num formulário Funcionários .

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.