QueryTables.Add(Object, Range, Object) Método

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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 QueryTable

Parâ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

QueryTable

Comentários

Uma consulta criada por esse método não é executada até que o Refresh(Object) método seja chamado.