Share via


PivotField.IncludeNewItemsInFilter Propriété

Définition

Permet aux développeurs de spécifier si les éléments exclus ou inclus doivent être suivis lorsque le PivotFieldfiltrage manuel est appliqué au . Lecture-écriture.

public:
 property bool IncludeNewItemsInFilter { bool get(); void set(bool value); };
public bool IncludeNewItemsInFilter { get; set; }
Public Property IncludeNewItemsInFilter As Boolean

Valeur de propriété

Boolean

Remarques

La valeur par défaut de cette propriété est False.

Lorsque le filtrage manuel est appliqué, les développeurs peuvent définir la propriété sur IncludeNewItemsInFilterTrue pour effectuer le suivi des éléments exclus. Ils peuvent définir la propriété sur False pour effectuer le suivi des éléments inclus.

Si de nouveaux éléments sont ajoutés aux données sources après que la IncludeNewItemsInFilter propriété a la valeur True, les nouveaux éléments apparaissent après PivotTable l’opération d’actualisation suivante, car ils ne figurent pas dans la collection d’éléments suivis par Excel.

Pour les hiérarchies OLAP, ce paramètre est défini sur l’objet CubeField et la tentative de le définir sur PivotFielddes éléments qui font partie d’une hiérarchie échoue (avec une erreur d’exécution). Vous pouvez obtenir ce paramètre à partir des PivotFieldéléments qui font partie d’une hiérarchie et il retourne le même que la propriété correspondante IncludeNewItemsInFilter .

Le basculement de ce paramètre efface les collections suivantes : HiddenItemsList, HiddenItems[Object], VisibleItemsListet VisibleItems[Object].

Lorsque IncludeNewItemsInFilter est défini sur False, les HiddenItemsList collections et HiddenItems[Object] sont vides et les éléments ne peuvent pas y être ajoutés. Une erreur d'exécution est renvoyée lorsque vous tentez d'ajouter des éléments.

Lorsque IncludeNewItemsInFilter a la valeur True, les VisibleItemsList collections et VisibleItems[Object] sont vides et les éléments ne peuvent pas y être ajoutés. Une erreur d'exécution est renvoyée lorsque vous tentez d'ajouter des éléments.

Dans PivotTable, ce paramètre est défini sur l’objet PivotField . Le basculement de ce paramètre ne modifie pas l'état du filtre.

S’applique à