Partilhar via


SlicerCaches.Add method (Excel) (Método SlicerCaches.Add [Excel])

Adiciona um novo objeto SlicerCache à coleção.

Sintaxe

expressão. Adicionar (Source, SourceField, Name, SlicerCacheType)

expressão Uma variável que representa um objeto SlicerCaches .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Source Obrigatório Variant A origem de dados na qual o novo objeto SlicerCache será baseado. O argumento repassado para o parâmetro Source pode ser um objeto WorkbookConnection, um objeto PivotTable ou uma cadeia de caracteres.

Se for transmitido um objeto de Tabela Dinâmica, o objeto PivotCache associado é utilizado como a origem de dados. Se for transmitida uma cadeia, é interpretada como o nome de um objeto WorkbookConnection e, se não existir um objeto WorkbookConnection , é gerado um erro de tempo de execução.
Campo de Origem Obrigatório Variant O nome do campo na fonte de dados que será usado na filtragem. Para origens de dados não OLAP, utilize o objeto Campo Dinâmico do objeto PivotCache no qual a segmentação de dados se baseia ou o nome exclusivo desse objeto (o valor do Campo Dinâmico.Propriedade name ).

Para fontes de dados OLAP, use o nome exclusivo MDX da hierarquia que serve de base para o SlicerCache. Também é possível especificar um nível da hierarquia OLAP, e o Excel usará a hierarquia correspondente.
Name Opcional Variant O nome que o Excel utiliza para referenciar a cache da segmentação de dados (o valor da Segmentação de DadosCache).Propriedade name ). Se for omitido, o Excel irá gerar um nome.

Por predefinição, o Excel concatena "Slicer_" com o valor do Campo Dinâmico. Propriedade legenda para segmentações de dados com origens de dados não OLAP ou com o valor de CubeField. Propriedade legenda para segmentações de dados com origens de dados OLAP (substituindo quaisquer espaços por "_").

Se for necessário tornar o nome exclusivo no espaço de nomes do livro, o Excel adiciona um número inteiro ao final do nome gerado. Se especificar um nome que já existe no espaço de nomes do livro, o método Add irá falhar.
SlicerCacheType Opcional XlSlicerCacheType Designa o tipo de segmentação de dados ou cache de segmentação de dados.

Valor de retorno

SlicerCache

Exemplo

O exemplo de código a seguir adiciona um cache de segmentação de dados com base na hierarquia OLAP de Customer Geography.

 ActiveWorkbook.SlicerCaches.Add(ActiveCell.PivotTable, _ 
 "[Customer].[Customer Geography]")

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.