ODBCConnection.Refresh 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 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.