Classe QueryTable - uma tabela de planilha construída a partir de dados retornados de uma fonte de dados externa (Excel VBA)

A classe QueryTable representa uma tabela de planilha construída a partir de dados retornados de uma fonte de dados externa, como um SQL Server ou um banco de dados do Microsoft Access.

As classes ListObject e Range. dão acesso à classe QueryTable


Dim qrytbl as QueryTable
Set qrytbl = ActiveCell.QueryTable

For Each

Aqui está um exemplo de processamento dos itens QueryTable em uma coleção. 


Dim qrytbl As QueryTable
For Each qrytbl In Application.QueryTables
	
Next qrytbl

Métodos

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

Delete - Exclui o objeto.

Refresh - Atualiza um intervalo de dados externos em um objeto QueryTable .

ResetTimer - Redefine o timer de atualização para a tabela de consulta especificada ou o relatório de tabela dinâmica para o último intervalo definido por você usando a propriedade RefreshPeriod .

SaveAsODC - Salva a origem do cache de tabela de consulta como um arquivo de conexão de dados do Microsoft Office.

Propriedades

AdjustColumnWidth True se as larguras das colunas forem automaticamente ajustadas para que seu conteúdo se encaixe melhor a cada atualização da tabela de consulta especificada. 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.

BackgroundQuery True se as consultas à tabela de consulta forem efetuadas de maneira assíncrona em segundo plano. Boolean de leitura/gravação.

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

CommandType Retorna ou define uma destas constantes XlCmdType : xlCmdCube, xlCmdDefault, xlCmdSqlou xlCmdTable. A constante que é retornada ou definida descreve o valor da propriedade CommandText . O valor padrão é xlCmdSQL. XlCmdType de leitura/gravação.

Connection Retorna ou define uma cadeia de caracteres que contém um dos seguintes:.

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 contendo o objeto QueryTable. Somente leitura intervalo.

EditWebPage Retorna ou define a URL Uniform Resource Locator da página da Web para uma consulta à Web. de leitura/gravação.

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.

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.

FetchedRowOverflow True se o número de setas retornadas pelo uso mais recente do método Refresh for maior que o número de setas disponíveis na planilha. Boolean somente leitura.

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.

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.

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

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.

Name Retorna ou define um valor String que representa o nome do objeto.

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

PostText Retorna ou define a cadeia de caracteres usada com o método post de inserir dados em um servidor Web para retornar dados de uma consulta da Web. String de leitura/gravação.

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 é True. Boolean de leitura/gravação.

PreserveFormatting True se alguma formatação comum às cinco primeiras linhas de dados for aplicada às novas linhas de dados na tabela de consulta. Células não usadas não sã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.

QueryType Indica o tipo de consulta usado pelo Microsoft Excel para preencher a tabela de consulta. Somente leitura XlQueryType.

Recordset Retorna ou define um objeto Recordset que é usado como a fonte de dados para a tabela de consulta especificada. Leitura/gravação.

Refreshing True se houver uma consulta em segundo plano em andamento para a tabela de consulta especificada. Boolean somente leitura.

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.

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

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.

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

RobustConnect Retorna ou define como a tabela de consulta se conecta à sua fonte de dados. Leitura/gravação XlRobustConnect.

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

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

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.

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

SourceConnectionFile Retorna ou define um String que indica o arquivo de conexão de dados do Microsoft Office ou um arquivo semelhante usado para criar a tabela de consulta. Leitura/gravação.

SourceDataFile Retorna ou define um valor String que indica o arquivo da fonte de dados referente a uma tabela de consulta.

TextFileColumnDataTypes Retorna ou define uma matriz ordenada de constantes que especificam 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. de leitura/gravação.

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.

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.

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.

TextFileFixedColumnWidths Retorna ou define uma matriz de 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 vão de 1 a 32767 caracteres. de leitura/gravação.

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.

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

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. Leitura/gravação XlPlatform.

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.

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

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.

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 32767. O valor padrão é 1. Long de leitura/gravação.

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.

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.

TextFileThousandsSeparator Retorna ou define o caractere separador de milhar 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.

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

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

WebConsecutiveDelimitersAsOne True se delimitadores consecutivos são tratados como um único delimitador quando você importa dados de marcas HTML em uma página da Web para uma tabela de consulta e se os dados devem ser 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.

WebDisableDateRecognition True se os dados que se parecem com datas são analisados como texto quando você importa 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.

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

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

WebPreFormattedTextToColumns Retorna ou define se os dados contidos nas marcas 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.

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

WebSingleBlockTextImport True se os dados das marcas HTML na página da Web especificada são processados todos ao mesmo tempo quando você importa 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.

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.

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

ListObject - Representa um objeto de lista na coleção ListObjects.

Parameters - Uma coleção de objetos Parameter para a tabela de consulta especificada.

Range - Representa uma célula, uma linha, uma coluna, uma seleção de células contendo um ou mais blocos contíguos de células ou um intervalo 3D.

Sort - Representa uma classificação de um intervalo de dados.

WorkbookConnection - Uma conexão é um conjunto de informações necessárias para obter dados de uma fonte de dados externa diferente de uma pasta de trabalho do Microsoft Excel.