PivotField.IncludeNewItemsInFilter Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 BooleanValeur 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.