Partilhar via


QueryTable Interface

Definição

Representa uma tabela de planilha criada a partir de dados retornados de uma fonte de dados externa, como um servidor SQL ou um banco de dados do Microsoft Access. O objeto QueryTable é um membro da QueryTables coleção.

public interface class QueryTable : Microsoft::Office::Interop::Excel::_QueryTable, Microsoft::Office::Interop::Excel::RefreshEvents_Event
[System.Runtime.InteropServices.Guid("00024428-0000-0000-C000-000000000046")]
public interface QueryTable : Microsoft.Office.Interop.Excel._QueryTable, Microsoft.Office.Interop.Excel.RefreshEvents_Event
Public Interface QueryTable
Implements _QueryTable, RefreshEvents_Event
Derivado
Atributos
Implementações

Comentários

This is a .NET interface derived from a COM coclass that is required by managed code for interoperability with the corresponding COM object. Use this derived interface to access all method, property, and event members of the COM object. However, if a method or event you want to use shares the same name under the same COM object, cast to the corresponding primary interface to call the method, and cast to the latest events interface to connect to the event. Refer to this topic for information about the COM object. Para obter informações sobre o método e os membros da propriedade do objeto COM, consulte _QueryTable.

Use QueryTables(index), onde index é o número de índice da tabela de consulta, para retornar um único objeto QueryTable .

Propriedades

AdjustColumnWidth

True se as larguras de coluna forem ajustadas automaticamente para o melhor ajuste sempre que você atualizar a tabela de consulta especificada ou o mapa XML. False se as larguras das colunas não forem ajustadas automaticamente a cada atualização. O valor padrão é True. Boolean de leitura/gravação.

(Herdado de _QueryTable)
Application

Retorna um Application objeto que representa o aplicativo Microsoft Excel. Somente leitura.

(Herdado de _QueryTable)
BackgroundQuery

True se as consultas para o relatório de Tabela Dinâmica ou tabela de consulta forem executadas de forma assíncrona (em segundo plano). Boolean de leitura/gravação.

(Herdado de _QueryTable)
CommandText

Retorna ou define a sequência de comando para a fonte de dados especificada. Objeto de leitura/gravação.

(Herdado de _QueryTable)
CommandType

Retorna ou define uma XlCmdType constante que descreve o tipo de comando associado à CommandText propriedade. O valor padrão é xlCmdSQL. Leitura/gravação XlCmdType.

(Herdado de _QueryTable)
Connection

Retorna ou define uma cadeia de caracteres que contém informações de conexão para a tabela de consulta. Objeto de leitura/gravação.

(Herdado de _QueryTable)
Creator

Retorna uma constante na XlCreator enumeração que indica o aplicativo no qual esse objeto foi criado. Se o objeto foi criado no Microsoft Excel, essa propriedade retornará a sequência XCEL, que é equivalente ao número hexadecimal 5843454C. Somente XlCreatorleitura .

(Herdado de _QueryTable)
Destination

Retorna a célula do 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 QueryTable objeto. Somente leitura intervalo.

(Herdado de _QueryTable)
EditWebPage

Retorna ou define a URL (localizador de recursos) uniforme da página da Web para uma consulta Da Web. Objeto de leitura/gravação.

(Herdado de _QueryTable)
EnableEditing

True se o usuário puder editar a tabela de consulta especificada. False se o usuário puder apenas atualizar a tabela de consulta. Boolean de leitura/gravação.

(Herdado de _QueryTable)
EnableRefresh

True se o o cache de tabela dinâmica ou de consulta pude ser atualizado pelo usuário. O valor padrão é True. Boolean de leitura/gravação.

(Herdado de _QueryTable)
FetchedRowOverflow

True se o número de linhas retornadas pelo último uso do Refresh(Object) método for maior do que o número de linhas disponíveis na planilha. Boolean somente leitura.

(Herdado de _QueryTable)
FieldNames

True se os nomes dos campos da fonte de dados aparecerem como títulos de coluna para os dados retornados. O valor padrão é True. Boolean de leitura/gravação.

(Herdado de _QueryTable)
FillAdjacentFormulas

True se as fórmulas à direita da tabela de consulta especificada forem atualizadas automaticamente sempre que a tabela de consulta for atualizada. Boolean de leitura/gravação.

(Herdado de _QueryTable)
HasAutoFormat

Reservado para uso interno.

(Herdado de _QueryTable)
ListObject

Retorna um ListObject objeto para o Range objeto ou QueryTable objeto. ListObject somente leitura.

(Herdado de _QueryTable)
MaintainConnection

True se a conexão com a fonte de dados especificada for mantida após a atualização e até a pasta de trabalho ser fechada. O valor padrão é True. Boolean de leitura/gravação.

(Herdado de _QueryTable)
Name

Retorna ou define o nome do objeto. String de leitura/gravação.

(Herdado de _QueryTable)
Parameters

Retorna uma Parameters coleção que representa os parâmetros da tabela de consulta. Somente leitura.

(Herdado de _QueryTable)
Parent

Retorna o objeto pai do objeto especificado. Somente leitura.

(Herdado de _QueryTable)
PostText

Retorna ou define a sequência de caracteres usada com o método de remessa de entrada de dados em um servidor Web para retornar dados de uma consulta à Web. String de leitura/gravação.

(Herdado de _QueryTable)
PreserveColumnInfo

True se as informações sobre classificação, filtragem e layout de colunas forem preservadas sempre que uma tabela de consulta for atualizada. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
PreserveFormatting

Essa propriedade será True se qualquer formatação comum às cinco primeiras linhas de dados for aplicada a novas linhas de dados na tabela de consulta. Células não utilizadas não serão formatadas. A propriedade será False se a última AutoFormatação aplicada à tabela de consulta for aplicada às novas linhas de dados. O valor padrão é True (a menos que a tabela de consulta tenha sido criada no Microsoft Excel 97 e a HasAutoFormat propriedade seja True, nesse caso PreserveFormatting é False). Boolean de leitura/gravação.

(Herdado de _QueryTable)
QueryType

Indica o tipo de consulta usada pelo Microsoft Excel para preencher a tabela de consulta ou o cache de Tabela Dinâmica. Somente XlQueryTypeleitura .

(Herdado de _QueryTable)
Recordset

Retorna ou define um objeto Recordset usado como fonte de dados para a tabela de consulta especificada ou cache de Tabela Dinâmica. Leitura/gravação.

(Herdado de _QueryTable)
Refreshing

True se houver uma consulta em segundo plano em andamento para a tabela de consulta especificada. Boolean de leitura/gravação.

(Herdado de _QueryTable)
RefreshOnFileOpen

True se a tabela de consulta ou o cache de tabela dinâmica for automaticamente atualizado toda vez que a pasta de trabalho for aberta. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
RefreshPeriod

Retorna ou define o número de minutos entre as atualizações. número inteiro de leitura/gravação.

(Herdado de _QueryTable)
RefreshStyle

Retorna ou define a maneira como as linhas da planilha especificada são adicionadas ou excluídas para acomodar o número de linhas em um conjunto de registros retornado por uma consulta. Leitura/gravação XlCellInsertionMode.

(Herdado de _QueryTable)
ResultRange

Retorna um Range objeto que representa a área da planilha ocupada pela tabela de consulta especificada. Somente leitura.

(Herdado de _QueryTable)
RobustConnect

Retorna ou define como o cache de tabela dinâmica se conectará à respectiva fonte de dados. Leitura/gravação XlRobustConnect.

(Herdado de _QueryTable)
RowNumbers

True se os números de linha forem adicionados como primeira coluna da tabela de consulta especificada. Boolean de leitura/gravação.

(Herdado de _QueryTable)
SaveData

True se os dados do relatório de tabela dinâmica forem salvos com a pasta de trabalho. False se somente a definição de relatório for salva. Boolean de leitura/gravação.

(Herdado de _QueryTable)
SavePassword

True se a informação de senha de uma sequência de conexão ODBC for salva junto com a consulta especificada. False se a senha for removida. Boolean de leitura/gravação.

(Herdado de _QueryTable)
Sort

Retorna os critérios de classificação do intervalo da tabela de consulta. Somente leitura.

(Herdado de _QueryTable)
SourceConnectionFile

Retorna ou define um String que indica o arquivo Microsoft Office Data Connection ou semelhante usado para criar a tabela dinâmica. Leitura/gravação.

(Herdado de _QueryTable)
SourceDataFile

Retorna ou define uma Cadeia de Caracteres que indica o arquivo de dados de origem para uma tabela de consulta.

(Herdado de _QueryTable)
Sql

Reservado para uso interno.

(Herdado de _QueryTable)
TablesOnlyFromHTML

Cria uma tabela de dados com base nas fórmulas e valores de entrada e definidos por você em uma planilha.

(Herdado de _QueryTable)
TextFileColumnDataTypes

Retorna ou define uma matriz de constantes ordenadas que especifica os tipos de dados aplicados às colunas correspondentes no arquivo de texto que você está importando para uma tabela de consulta. A constante padrão para cada coluna é xlGeneral. Objeto de leitura/gravação.

(Herdado de _QueryTable)
TextFileCommaDelimiter

True se a vírgula for o delimitador quando você importar um arquivo de texto para uma tabela de consulta. False se desejar usar algum outro caractere como o delimitador. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
TextFileConsecutiveDelimiter

True se os delimitadores consecutivos forem tratados como um único delimitador quando você importar um arquivo de texto para uma tabela de consulta. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
TextFileDecimalSeparator

Retorna ou define o caractere separador decimal que o Microsoft Excel usa quando você importa um arquivo de texto para uma tabela de consulta. O padrão é o caractere separador decimal do sistema. String de leitura/gravação.

(Herdado de _QueryTable)
TextFileFixedColumnWidths

Retorna ou define uma matriz de números inteiros que correspondem às larguras das colunas (em caracteres) no arquivo de texto que você está importando para uma tabela de consulta. As larguras válidas são de 1 a 32.767 caracteres. Objeto de leitura/gravação.

(Herdado de _QueryTable)
TextFileOtherDelimiter

Retorna ou define o caractere usado como o delimitador quando você importa um arquivo de texto para uma tabela de consulta. O valor padrão é Null. String de leitura/gravação.

(Herdado de _QueryTable)
TextFileParseType

Retorna ou define o formato de coluna para os dados no arquivo de texto que está sendo importado para uma tabela de consulta. Leitura/gravação XlTextParsingType.

(Herdado de _QueryTable)
TextFilePlatform

Retorna ou define a origem do arquivo de texto que você está importando para a tabela de consulta. Essa propriedade determina que página de código será usada durante a importação de dados. O valor padrão é a definição atual da opção Origem do arquivo no Assistente de importação de texto. Leitura/gravação XlPlatform.

(Herdado de _QueryTable)
TextFilePromptOnRefresh

True se você desejar especificar o nome do arquivo de texto importado sempre que a tabela de consulta for atualizada. A caixa de diálogo Importar arquivo de texto permite que você especifique o caminho e o nome do arquivo. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
TextFileSemicolonDelimiter

True se o ponto e vírgula for o delimitador quando você importar um arquivo de texto para uma tabela de consulta e se o valor da TextFileParseType propriedade for xlDelimited. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
TextFileSpaceDelimiter

True se o caractere de espaço for o delimitador quando você importar um arquivo de texto para uma tabela de consulta. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
TextFileStartRow

Retorna ou define o número da linha em que a análise de texto começará quando você importar um arquivo de texto para uma tabela de consulta. Os valores válidos são inteiros de 1 a 32.767. O valor padrão é 1. número inteiro de leitura/gravação.

(Herdado de _QueryTable)
TextFileTabDelimiter

True se o caractere de tabulação for o delimitador quando você importar um arquivo de texto para uma tabela de consulta. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
TextFileTextQualifier

Retorna ou define o qualificador de texto quando você importa um arquivo de texto para uma tabela de consulta. O qualificador de texto especifica que os dados incluídos estão em formato de texto. Leitura/gravação XlTextQualifier.

(Herdado de _QueryTable)
TextFileThousandsSeparator

Retorna ou define o caractere separador milhares que o Microsoft Excel usa quando você importa um arquivo de texto para uma tabela de consulta. O padrão é o caractere separador de milhar do sistema. String de leitura/gravação.

(Herdado de _QueryTable)
TextFileTrailingMinusNumbers

True para o Microsoft Excel tratar números importados como texto que começam com um símbolo "-" como um número negativo. False para o Excel tratar números importados como texto que comece com um símbolo "-" como texto. Boolean de leitura/gravação.

(Herdado de _QueryTable)
TextFileVisualLayout

Retorna ou define uma XlTextVisualLayoutType constante que indica se o layout visual do texto que está sendo importado é da esquerda para a direita ou da direita para a esquerda.

(Herdado de _QueryTable)
WebConsecutiveDelimitersAsOne

True se delimitadores consecutivos forem tratados como um único delimitador quando você importar dados de marcas DE PRE> HTML <em uma página da Web em uma tabela de consulta e se os dados forem analisados em colunas. False se você desejar tratar os delimitadores consecutivos como vários delimitadores. O valor padrão é True. Boolean de leitura/gravação.

(Herdado de _QueryTable)
WebDisableDateRecognition

True se os dados que se parecerem com datas forem analisados como texto quando você importar uma página da Web para uma tabela de consulta. False se o reconhecimento de data for usado. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
WebDisableRedirections

True se os redirecionamentos de consulta da Web estiverem desabilitados para um QueryTable objeto. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
WebFormatting

Retorna ou define um valor que determina a quantidade de formatação de uma página da Web, se houver, que será aplicada quando você importar a página para uma tabela de consulta. Leitura/gravação XlWebFormatting.

(Herdado de _QueryTable)
WebPreFormattedTextToColumns

Retorna ou define se os dados contidos em marcas de PRE> HTML <na página da Web são analisados em colunas quando você importa a página para uma tabela de consulta. O padrão é True. Boolean de leitura/gravação.

(Herdado de _QueryTable)
WebSelectionType

Retorna ou define um valor que determina se uma página da Web inteira, todas as tabelas nela contidas ou somente tabelas específicas serão importadas para uma tabela de consulta. Leitura/gravação XlWebSelectionType.

(Herdado de _QueryTable)
WebSingleBlockTextImport

True se os dados das marcas DE PRE> HTML <na página da Web especificada forem processados de uma só vez quando você importar a página para uma tabela de consulta. False se os dados forem importados em blocos de linhas contíguas para que as linhas de cabeçalho sejam reconhecidas como tais. O valor padrão é False. Boolean de leitura/gravação.

(Herdado de _QueryTable)
WebTables

Retorna ou define uma lista delimitada por vírgulas de nomes de tabela ou números de índice de tabela quando você importa uma página da Web para uma tabela de consulta. String de leitura/gravação.

(Herdado de _QueryTable)
WorkbookConnection

Retorna o WorkbookConnection objeto que a tabela de consulta usa. Somente leitura.

(Herdado de _QueryTable)

Métodos

CancelRefresh()

Cancela todas as consultas em segundo plano da tabela de consultas especificada. Use a Refreshing propriedade para determinar se uma consulta em segundo plano está em andamento no momento.

(Herdado de _QueryTable)
Delete()

Exclui o objeto.

(Herdado de _QueryTable)
Refresh(Object)

Atualizações um intervalo de dados externo (QueryTable). Boolean.

(Herdado de _QueryTable)
ResetTimer()

Redefine o temporizador de atualização para a tabela de consulta especificada ou o relatório de Tabela Dinâmica para o último intervalo definido usando a RefreshPeriod propriedade.

(Herdado de _QueryTable)
SaveAsODC(String, Object, Object)

Salva a fonte de cache de Tabela Dinâmica como um arquivo de Conexão de Dados do Microsoft Office.

(Herdado de _QueryTable)

Eventos

AfterRefresh

Ocorre após uma consulta ser concluída ou cancelada.

(Herdado de RefreshEvents_Event)
BeforeRefresh

Ocorre antes de qualquer atualização da tabela de consultas. Isso inclui as atualizações que resultam ao chamar o método Refresh, das ações do usuário no produto e da abertura da pasta de trabalho que contém a tabela de consultas.

(Herdado de RefreshEvents_Event)

Aplica-se a