QueryTables.Add(Object, Range, 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.
Cria uma nova tabela de consulta. Retorna um QueryTable objeto que representa a nova tabela de consulta.
public Microsoft.Office.Interop.Excel.QueryTable Add (object Connection, Microsoft.Office.Interop.Excel.Range Destination, object Sql);Public Function Add (Connection As Object, Destination As Range, Optional Sql As Object) As QueryTableParâmetros
- Connection
- Object
Objeto obrigatório. A fonte de dados para a tabela de consulta. Pode ser uma das seguintes:uma cadeia de caracteres que contém uma cadeia de conexão OLE DB ou ODBC. O ODBC cadeia de conexão tem o formulário "ODBC;<>cadeia de conexão". Um objeto QueryTable do qual as informações de consulta são inicialmente copiadas, incluindo o cadeia de conexão e o texto SQL, mas não incluindo o Destination intervalo. Especificar um objeto QueryTable faz com que o Sql argumento seja ignorado. Um objeto ADO ou DAO Recordset . Os dados são lidos do conjunto de registros ADO ou DAO. O Microsoft Excel mantém o conjunto de recursos até a tabela de consulta ser excluída ou a conexão ser alterada. A tabela de consulta resultante não pode ser editada. Uma consulta da Web. Uma cadeia de caracteres no formulário "URL;<url>", em que "URL;" é necessário, mas não localizado e o restante da cadeia de caracteres é usado para a URL da consulta Web. Localizador de dados. Uma cadeia de caracteres no formulário "FINDER;<caminho> do arquivo do localizador de dados" em que "FINDER;" é necessário, mas não localizado. O resto da cadeia de caracteres é o caminho e o nome do arquivo de um arquivo do Data Finder (*.dqy ou *.iqy). O arquivo é lido quando o método Add é executado; chamadas subsequentes para a Connection propriedade da tabela de consulta retornarão cadeias de caracteres começando com "ODBC;" ou "URL;", conforme apropriado. Um arquivo de texto. Uma cadeia de caracteres no formulário "TEXT;<caminho e nome> do arquivo de texto", em que TEXT é necessário, mas não localizado.
- Destination
- Range
Intervalo necessário. A célula no canto superior esquerdo do intervalo de destino da tabela de consulta (o intervalo onde a tabela de consulta resultante será colocada). O intervalo de destino deve estar na planilha que contém o QueryTables objeto.
- Sql
- Object
Objeto opcional. A cadeia de caracteres de consulta SQL a ser executada na fonte de dados ODBC. Esse argumento é opcional quando você está usando uma fonte de dados ODBC Você não pode usar esse argumento quando um objeto QueryTable , um arquivo de texto ou um objeto ADO ou DAO Recordset é especificado como a fonte de dados.
Retornos
Comentários
Uma consulta criada por esse método não é executada até que o Refresh(Object) método seja chamado.