Método SlicerCaches.Add (Excel)

Adiciona um novo objeto SlicerCache à coleção.

Sintaxe

mais simples. 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 fonte 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 um objeto de Tabela Dinâmica for passado, o objeto PivotCache associado será usado como a fonte de dados. Se uma cadeia de caracteres for passada, ela será interpretada como o nome de um objeto WorkbookConnection e, se esse objeto WorkbookConnection não existir, um erro em tempo de execução será gerado.
Campo de origem Obrigatório Variant O nome do campo na fonte de dados que será usado na filtragem. Para fontes de dados não OLAP, use o objeto PivotField do objeto PivotCache no qual a segmentação se baseia ou o nome exclusivo desse objeto (o valor do PivotField.Name (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 usa para fazer referência ao cache de segmentação (o valor do SlicerCache.Name (Propriedade Name ). Se omitido, o Excel gerará um nome.

Por padrão, o Excel concatena "Slicer_" com o valor do PivotField. Propriedade de legenda para segmentações de dados com fontes de dados não OLAP ou com o valor de CubeField. Propriedade de legenda para segmentações de dados com fontes de dados OLAP (substituindo espaços por "_").

Se necessário para tornar o nome exclusivo no namespace da pasta de trabalho, o Excel adicionará um número inteiro ao final do nome gerado. Se você especificar um nome que já existe no namespace da pasta de trabalho, o método Add falhará.
SlicerCacheType Opcional XlSlicerCacheType Designa o tipo de segmentação de dados ou cache de segmentação.

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.