Método SlicerCaches.Add (Excel)

Artigo
04/07/2023

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	Variantes	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 PivotTable for passado, o objeto PivotCache associado será usado como fonte de dados. Se uma cadeia de caracteres for passada, ela será interpretada como o nome de um objeto WorkbookConnection e, se nenhum objeto WorkbookConnection existir, um erro de tempo de execução será gerado.
SourceField	Obrigatório	Variantes	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 o segmentador se baseia ou o nome exclusivo desse objeto (o valor do PivotField. 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	Variantes	O nome que o Excel usa para referenciar o cache de segmentação (o valor do SlicerCache. Propriedade Name ). Se omitido, o Excel gerará um nome. Por padrão, o Excel concatena "Slicer_" com o valor do PivotField. Propriedade Caption para segmentações com fontes de dados não OLAP ou com o valor do CubeField. Propriedade Caption para segmentações com fontes de dados OLAP (substituindo todos os espaços por "_"). Se necessário tornar o nome exclusivo no namespace da pasta de trabalho, o Excel adicionará um inteiro ao final do nome gerado. Se você especificar um nome que já existe no namespace da pasta de trabalho, o método Adicionar falhará.
SlicerCacheType	Opcional	XlSlicerCacheType	Designa o tipo de cache de segmentação ou 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.