Método Worksheet.PivotTableWizard (Excel)

Cria um novo relatório de Tabela Dinâmica. Esse método não exibe o Assistente de Tabela Dinâmica. Esse método não está disponível para fontes de dados OLE DB. Use o método Adicionar para adicionar um cache de Tabela Dinâmica e crie um relatório de Tabela Dinâmica com base no cache.

Sintaxe

expressão. PivotTableWizard (SourceType, SourceData, TableDestination, TableName, RowGrand, ColumnGrand, SaveData, HasAutoFormat, AutoPage, Reserved, BackgroundQuery, OptimizeCache, PageFieldOrder, PageFieldWrapCount, ReadData, Connection)

Expressão Uma variável que representa um objeto Worksheet .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
SourceType	Opcional	Variantes	Um valor XlPivotTableSourceType que representa a origem dos dados do relatório. Se você especificar este argumento, deverá especificar também SourceData. Se SourceType e SourceData forem omitidos, o Microsoft Excel assumirá que o tipo de origem é xlDatabase e os dados de origem serão provenientes do banco de dados de intervalo nomeado. Se esse intervalo nomeado não existir, o Excel usará a região atual se a seleção atual estiver em um intervalo de mais de 10 células que contêm dados. Se isso não for verdade, esse método falhará.
SourceData	Opcional	Variantes	Os dados para o novo relatório. Pode ser um objeto Range , uma matriz de intervalos ou uma constante de texto que representa o nome de outro relatório. Em um banco de dados externo, SourceData é uma matriz de sequências que contêm a sequência de consulta SQL, na qual cada elemento tem no máximo 255 caracteres. Você deve usar o argumento Connection para especificar a sequência de conexão ODBC. Para obter compatibilidade com as versões anteriores do Excel, SourceData pode ser uma matriz de dois elementos. O primeiro elemento é a sequência de conexão que especifica a fonte ODBC referente aos dados. O segundo elemento é a sequência de consulta SQL usada para obter os dados. Se você especificar o argumento SourceData, deverá especificar também SourceType. Se a célula ativa estiver dentro do intervalo SourceData, também será preciso especificar TableDestination.
TableDestination	Opcional	Variantes	Um objeto Range que especifica onde o relatório deve ser inserido na planilha. Se este argumento for omitido, o relatório será inserido na célula ativa.
TableName	Opcional	Variantes	Uma sequência de caracteres especificando o nome do novo relatório.
RowGrand	Opcional	Variantes	True para exibir totais para linhas no relatório.
ColumnGrand	Opcional	Variantes	True para exibir totais para colunas do relatório.
SaveData	Opcional	Variantes	True para salvar dados com o relatório. False para salvar apenas a definição do relatório.
HasAutoFormat	Opcional	Variantes	True para que o Excel formate automaticamente o relatório quando ele é atualizado ou quando os campos são movidos.
Autopage	Opcional	Variantes	Válido somente se SourceType for xlConsolidation. True para que o Excel crie um campo de página para a consolidação. Se AutoPage for False, você precisará criar o(s) campo(s) de página.
Reserved	Opcional	Variantes	Não usado pelo Excel.
BackgroundQuery	Opcional	Variantes	True para que o Excel faça consultas ao relatório de forma assíncrona (no segundo plano). O valor padrão é False.
OptimizeCache	Opcional	Variantes	True para otimizar o cache de tabela dinâmica quando ela for construída. O valor padrão é False.
PageFieldOrder	Opcional	Variantes	A ordem na qual os campos de página são adicionados ao layout do relatório de Tabela Dinâmica. Pode ser uma das seguintes constantes XlOrder : xlDownThenOver (padrão) ou xlOverThenDown.
PageFieldWrapCount	Opcional	Variantes	O número de campos de página em cada coluna ou linha no relatório de tabela dinâmica. O valor padrão é 0 (zero).
Readdata	Opcional	Variantes	True para criar um cache de tabela dinâmica que contenha todos os registros do banco de dados externo; este cache pode ser muito grande. Se ReadData for False, você poderá definir alguns dos campos como campos de página baseados em servidor antes que os dados sejam realmente lidos.
Connection	Opcional	Variantes	Uma sequência que contém configurações de ODBC que permitem ao Excel conectar-se a uma fonte de dados ODBC. A cadeia de conexão tem o formulário ODBC;<connection string>. Esse argumento substitui qualquer configuração anterior para a propriedade Connection do objeto PivotCache.

Valor de retorno

Um objeto de Tabela Dinâmica que representa o novo relatório de Tabela Dinâmica.

Exemplo

Este exemplo cria um novo relatório de Tabela Dinâmica de um banco de dados do Excel (contido no intervalo A1:C100).

ActiveSheet.PivotTableWizard xlDatabase, Range("A1:C100")

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.