_QueryTable.Refresh(Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Atualizações um intervalo de dados externo (QueryTable). Boolean.
public bool Refresh (object BackgroundQuery);Public Function Refresh (Optional BackgroundQuery As Object) As BooleanParâ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
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.