PivotField.IncludeNewItemsInFilter Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 BooleanValor da propriedade
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.