_QueryTable.Refresh(Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Atualizações um intervalo de dados externo (QueryTable). Boolean.

public bool Refresh (object BackgroundQuery);

Public Function Refresh (Optional BackgroundQuery As Object) As Boolean

Parâmetros

BackgroundQuery

Object

Objeto opcional. 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 BackgroundQuery propriedade determinará o modo de consulta.

Retornos

Boolean

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, o Microsoft Excel usa o cadeia de conexão especificado pela Connection propriedade. 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 DisplayAlerts propriedade for False, as caixas de diálogo não serão exibidas e o método Atualizar falhará com a exceção 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 o cadeia de conexão concluído examinando o valor da Connection propriedade.

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 Parameters coleção 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 serão exibidas para o usuário, independentemente da configuração da DisplayAlerts propriedade. 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 FetchedRowOverflow propriedade. Essa propriedade é inicializada sempre que o método Refresh é chamado.