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 caracteres de conexão OLE DB ou ODBC. A cadeia de caracteres de conexão ODBC tem o formulário "ODBC; < cadeia de conexão > ". Um objeto QueryTable do qual as informações de consulta são inicialmente copiadas, incluindo a cadeia de caracteres de conexão e SQL texto, mas não incluindo o Destination intervalo. A especificação de um objeto QueryTable faz com que Sql o argumento seja ignorado. Um objeto Recordset do ADO ou do DAO. 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 formato "URL; < url ", onde "URL;" é necessária, mas não localizada e o restante da cadeia de caracteres é usado para a > URL da consulta Web. Data Finder. Uma cadeia de caracteres no formato "FINDER; < caminho do arquivo do localizador > de dados " onde "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 à propriedade da tabela de consulta retornarão cadeias de caracteres começando com Connection "ODBC;" ou "URL", conforme apropriado. Um arquivo de texto. Uma cadeia de caracteres no formato "TEXT; < caminho e nome do arquivo de texto > ", onde TEXT é necessário, mas não localizado.
- Destination
- Range
Intervalo obrigató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 Não é possível usar esse argumento quando um objeto QueryTable, um arquivo de texto ou um objeto Recordset do ADO ou do DAO é especificado como a fonte de dados.
Retornos
Comentários
Uma consulta criada por esse método não será executado até que Refresh(Object) o método seja chamado.