Método QueryTable.Refresh (Excel)

Atualiza um intervalo de dados externo em um objeto QueryTable.

Sintaxe

expressão. Refresh (BackgroundQuery)

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
BackgroundQuery Opcional Variant Usado somente com QueryTables baseadas nos resultados de uma consulta SQL. True para retornar o controle ao procedimento assim que uma conexão de banco de dados for feita e a consulta for enviada. A QueryTable é atualizada em segundo plano. False para retornar o controle ao procedimento somente depois que todos os dados tiverem sido buscados na planilha.

Se esse argumento não for especificado, a configuração da propriedade BackgroundQuery determinará o modo da consulta.

Valor de retorno

Booliano

Comentários

Os comentários a seguir se aplicam a objetos QueryTable baseados nos resultados de uma consulta SQL.

O método Refresh faz com que o Microsoft Excel se conecte à fonte de dados do objeto QueryTable, execute a consulta SQL e retorne os dados para o intervalo baseado no objeto QueryTable. A menos que esse método seja chamado, o objeto QueryTable não se comunicará com a fonte de dados.

Ao fazer a conexão com a fonte de dados OLE DB ou ODBC, Microsoft Excel usa a cadeia de caracteres de conexão especificada pela propriedade Connection. Se a cadeia de conexão especificada não tiver os valores necessários, serão exibidas caixas de diálogo para solicitar ao usuário as informações necessárias. Se a propriedade DisplayAlerts for False, as caixas de diálogo não serão exibidas e o método Refresh falhará com a exceção de informações de conexão insuficientes.

Depois de fazer uma conexão bem-sucedida, o Microsoft Excel armazena a cadeia de conexão completa para que os avisos não sejam exibidos em chamadas subsequentes para o método Refresh durante a mesma sessão de edição. Você pode obter a cadeia de conexão concluída ao examinar o valor da propriedade Connection.

Depois que a conexão de banco de dados tiver sido estabelecida, a consulta SQL será validada. Se a consulta não for válida, o método Refresh falhará com a exceção de erro de sintaxe SQL.

Se a consulta exigir parâmetros, a coleção Parameters deverá ser inicializada com informações de associação de parâmetros antes que o método Refresh seja chamado. Se não houver parâmetros suficientes associados, o método Refresh falhará com a exceção de erro de parâmetro. Se os parâmetros forem definidos para solicitar seus valores, as caixas de diálogo são exibidas para o usuário, independentemente da configuração da propriedade DisplayAlerts. Se o usuário cancelar uma caixa de diálogo de parâmetro, o método Refresh será interrompido e retornará False. Se parâmetros extras forem vinculados à coleção Parameters, esses parâmetros extras serão ignorados.

O método Refresh retornará True se a consulta for concluída ou iniciada com êxito; ele retornará False se o usuário cancelar uma caixa de diálogo de conexão ou de parâmetro.

Para ver se o número de linhas buscadas excedeu o número de linhas disponíveis na planilha, examine a propriedade FetchedRowOverflow. Essa propriedade é inicializada sempre que o método Refresh é chamado.

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.