Método ODBCConnection.Refresh (Excel)

Atualiza uma conexão ODBC.

Sintaxe

expressão. Atualização

Expressão Uma variável que representa um objeto ODBCConnection .

Comentários

Ao fazer a conexão com a fonte de dados ODBC, o Microsoft Excel usa a cadeia 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 Atualizar falhará com a exceção Informações de Conexão Insuficientes.

Depois que o Excel faz uma conexão bem-sucedida, ele armazena a cadeia de conexão concluída para que os prompts não sejam exibidos para chamadas subsequentes ao método Atualizar 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 Parâmetros deve 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.