PivotField.IncludeNewItemsInFilter Propriedade

Definição

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

Permite que os desenvolvedores especifiquem se itens excluídos ou incluídos devem ser rastreados quando a filtragem manual é aplicada ao PivotField. Leitura/gravação.

public:
 property bool IncludeNewItemsInFilter { bool get(); void set(bool value); };

public bool IncludeNewItemsInFilter { get; set; }

Public Property IncludeNewItemsInFilter As Boolean

Valor da propriedade

Boolean

Boolean

Comentários

O valor padrão para essa propriedade é False.

Quando a filtragem manual é aplicada, os desenvolvedores podem definir a IncludeNewItemsInFilter propriedade como True para rastrear itens excluídos. Eles podem definir a propriedade como False para rastrear itens incluídos.

Se novos itens forem adicionados aos dados de origem depois que a IncludeNewItemsInFilter propriedade for definida como True, os novos itens serão exibidos no após a PivotTable próxima operação de atualização porque eles não estão na coleção de itens que o Excel está acompanhando.

Para hierarquias OLAP, essa configuração é definida no CubeField objeto e tentar defini-la em PivotFields que fazem parte de uma hierarquia falhará (com um erro em tempo de execução). Você pode obter essa configuração dos PivotFields que fazem parte de uma hierarquia e ela retornará o mesmo que a propriedade correspondente IncludeNewItemsInFilter .

A agregação dessa configuração limpará as seguintes coleções: HiddenItemsList, HiddenItems[Object], VisibleItemsListe VisibleItems[Object].

Quando IncludeNewItemsInFilter é definido como False, as HiddenItemsList coleções e HiddenItems[Object] estão vazias e os itens não podem ser adicionados a eles. Um erro em tempo de execução será retornado ao tentar adicionar itens.

Quando IncludeNewItemsInFilter é definido como True, as VisibleItemsList coleções e VisibleItems[Object] estão vazias e os itens não podem ser adicionados a eles. Um erro em tempo de execução será retornado ao tentar adicionar itens.

Em PivotTables, essa configuração é definida no PivotField objeto. Ativar/desativar essa configuração não mudará o estado do filtro.