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 | 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.