Classe PivotCaches - a coleção de caches de memória dos relatórios de tabela dinâmica em uma pasta de trabalho (Excel VBA)

A classe PivotCaches representa a coleção de caches de memória dos relatórios de tabela dinâmica em uma pasta de trabalho. Para usar uma variável de classe PivotCaches, ela primeiro precisa ser instanciada por exemplo


Dim pcs as PivotCaches
Set pcs = ActiveWorkbook.PivotCaches()

For Each

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


Dim pvtcac As PivotCache
For Each pvtcac In ActiveWorkbook.PivotCaches()
	
Next pvtcac

Count

Retorna um valor Long que representa o número de objetos na coleção.


Dim lngCount As Long
lngCount = ActiveWorkbook.PivotCaches.Count

Create

Cria um novo PivotCache.

As duas constantes XlPivotTableSourceType a seguir não são suportadas ao criar um PivotCache usando este método: xlPivotTable e xlScenario. Um erro em tempo de execução será retornado se uma dessas duas constantes for fornecida. O argumento SourceData será requerido se SourceType não for xlExternal. Deve ser passado um objeto Range (quando SourceType é xlConsolidation ou xlDatabase) ou um objeto WorkbookConnection (quando SourceType é xlExternal). Ao transmitir um objeto Range , recomendamos que você use uma cadeia de caracteres para especificar a pasta de trabalho, a planilha e o intervalo de células, ou configurar um intervalo nomeado e passar o nome como uma cadeia de caracteres. Passar um objeto Range pode causar erros de "incompatibilidade de tipo" inesperadamente. Quando não for fornecido, a versão da tabela dinâmica será xlPivotTableVersion12. O uso da constante xlPivotTableVersionCurrent não é permitido e retorna um erro em tempo de execução se for fornecida.

Create (SourceType, SourceData, Version)


Dim pvtcacCreate As PivotCache
Set pvtcacCreate = ActiveWorkbook.PivotCaches.Create(SourceType:=xlConsolidation)

Arguments

O seguinte argumento é necessário

SourceType (XlPivotTableSourceType) - SourceType pode ser uma destas constantes XlPivotTableSourceType : xlConsolidation, xlDatabaseou xlExternal.


Os valores possíveis são

xlConsolidation Vários intervalos de consolidação.
xlDatabase Banco de dados ou lista do Microsoft Excel.
xlExternal Dados de um outro aplicativo.
xlPivotTable Mesma fonte que a de um outro relatório de tabela dinâmica.
xlScenario Dados baseados em cenários criados com o Gerenciador de Cenários.

Optional arguments

Os seguintes argumentos são opcionais

SourceData - Os dados para o novo cache da tabela dinâmica

Version (XlPivotTableVersionList) - Versão da tabela dinâmica. Version pode ser uma das constantes XlPivotTableVersionList .


Os valores possíveis são

xlPivotTableVersion10 Excel 2002Excel 2002
xlPivotTableVersion11 Excel 2003Excel 2003
xlPivotTableVersion12 Excel 2007Excel 2007
xlPivotTableVersion14 Excel 2010Excel 2010
xlPivotTableVersion15 Excel 2013Excel 2013
xlPivotTableVersion2000 Excel 2000Excel 2000
xlPivotTableVersionCurrent Fornecido apenas para compatibilidade com versões anteriores

Item

Retorna um único objeto de uma coleção.

Item (Index)

Index: O nome ou número de índice do objeto.


Dim pvtcac As PivotCache
Set pvtcac = ActiveWorkbook.PivotCaches(Index:=1)