Compartilhar via


ODBCConnection.Refresh Método

Definição

Atualiza uma conexão ODBC.

public:
 void Refresh();
public void Refresh ();
Public Sub Refresh ()

Comentários

Ao fazer a conexão com a fonte de dados 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 Refresh() método falhará com a exceção Informações de Conexão Insuficientes.

Depois que o Microsoft Excel faz uma conexão bem-sucedida, ele armazena o cadeia de conexão concluído para que os prompts não sejam exibidos para chamadas subsequentes ao Refresh() método 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 Refresh() método falhará com a exceção de Erro de Sintaxe SQL.

Se a consulta exigir parâmetros, a Parameters coleção deve ser inicializada com informações de associação de parâmetros antes que o Refresh() método seja chamado. Se não tiverem sido associados parâmetros suficientes, o Refresh() método 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 Refresh() método interromperá e retornará False. Se parâmetros extras estiverem associados à Parameters coleção, esses parâmetros extras serão ignorados.

O Refresh() método retorna True se a consulta for concluída ou iniciada com êxito; ela retornará False se o usuário cancelar uma caixa de diálogo de conexão ou 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 Refresh() método é chamado.

Aplica-se a