ODBCConnection.Refresh (Excel)

Atualiza uma conexão ODBC.

Ao fazer a conexão com a fonte de dados ODBC, o Microsoft Excel usa a sequência 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 que o Excel faz uma conexão bem-sucedida, ele armazena a cadeia de caracteres de conexão concluída, de modo que os prompts não serão exibidos para 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 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âmetro 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 excede o número de linhas disponíveis na planilha, examine a propriedade FetchedRowOverflow . Essa propriedade é inicializada sempre que o método Refresh é chamado.

ActiveWorkbook.Connections(1).ODBCConnection.Refresh