Método Refresh (ADO)

Artigo
05/30/2023

Atualiza os objetos em uma coleção para refletir os objetos disponíveis no provedor e específicos dele.

Sintaxe

  
collection.Refresh

Comentários

O método Refresh realiza tarefas diferentes dependendo da coleção da qual você a chama.

Parâmetros

O uso do método Refresh na coleção Parameters de um objeto Command recupera as informações de parâmetro do lado do provedor para o procedimento armazenado ou a consulta parametrizada especificada no objeto Command. A coleção estará vazia para os provedores que não dão suporte às chamadas de procedimento armazenado ou às consultas parametrizadas.

Você deve definir a propriedade ActiveConnection do objeto Command como um objeto Connection válido, a propriedade CommandText como um comando válido e a propriedade CommandType como adCmdStoredProc antes de chamar o método Refresh.

Se você acessar a coleção Parameters antes de chamar o método Refresh, o ADO chamará automaticamente o método e preencherá a coleção para você.

Observação

Se você usar o método Refresh para obter informações de parâmetro do provedor e ele retornar um ou mais objetos Parameter do tipo de dados de comprimento variável, o ADO poderá alocar memória para os parâmetros com base no tamanho potencial máximo, o que causará um erro durante a execução. Você deve definir explicitamente a propriedade Size desses parâmetros antes de chamar o método Execute para evitar erros.

Campos

O uso do método Refresh na coleção Fields não tem nenhum efeito visível. Para recuperar alterações da estrutura de banco de dados subjacente, use o método Requery ou, se o objeto Recordset não der suporte a indicadores, o método MoveFirst.

Propriedades

O uso do método Refresh em uma coleção Properties de alguns objetos preenche a coleção com as propriedades dinâmicas expostas pelo provedor. Essas propriedades fornecem informações sobre a funcionalidade específica do provedor, além das propriedades internas às quais o ADO dá suporte.