PivotField.IncludeNewItemsInFilter Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ermöglicht Entwicklern anzugeben, ob ausgeschlossene oder eingeschlossene Elemente nachverfolgt werden sollen, wenn die manuelle Filterung auf angewendet PivotFieldwird. Lese-/Schreibzugriff.
public:
property bool IncludeNewItemsInFilter { bool get(); void set(bool value); };public bool IncludeNewItemsInFilter { get; set; }Public Property IncludeNewItemsInFilter As BooleanEigenschaftswert
Boolean
Hinweise
Der Standardwert für diese Eigenschaft ist False.
Wenn die manuelle Filterung angewendet wird, können Entwickler die IncludeNewItemsInFilter Eigenschaft auf True festlegen, um ausgeschlossene Elemente nachzuverfolgen. Sie können die -Eigenschaft auf False festlegen, um eingeschlossene Elemente nachzuverfolgen.
Wenn den Quelldaten neue Elemente hinzugefügt werden, nachdem die IncludeNewItemsInFilter Eigenschaft auf True festgelegt wurde, werden die neuen Elemente im PivotTable nach dem nächsten Aktualisierungsvorgang angezeigt, da sie sich nicht in der Auflistung von Elementen befinden, die Excel nachverfolgt.
Bei OLAP-Hierarchien wird diese Einstellung für das CubeField -Objekt festgelegt, und der Versuch, sie auf PivotFields festzulegen, die Teil einer Hierarchie sind, schlägt fehl (mit einem Laufzeitfehler). Sie können diese Einstellung aus den PivotFields abrufen, die Teil einer Hierarchie sind, und es wird das gleiche wie die entsprechende IncludeNewItemsInFilter Eigenschaft zurückgegeben.
Durch Umschalten dieser Einstellung werden die folgenden Auflistungen gelöscht: HiddenItemsList, HiddenItems[Object], VisibleItemsListund VisibleItems[Object].
Wenn IncludeNewItemsInFilter auf False festgelegt ist, sind die HiddenItemsList Auflistungen und HiddenItems[Object] leer, und es können keine Elemente hinzugefügt werden. Bei dem Versuch, Elemente hinzuzufügen, wird ein Laufzeitfehler zurückgegeben.
Wenn IncludeNewItemsInFilter auf True festgelegt ist, sind die VisibleItemsList Auflistungen und VisibleItems[Object] leer, und es können keine Elemente hinzugefügt werden. Bei dem Versuch, Elemente hinzuzufügen, wird ein Laufzeitfehler zurückgegeben.
In PivotTables wird diese Einstellung für das PivotField -Objekt festgelegt. Das Umschalten dieser Einstellung hat keinen Einfluss auf den Zustand des Filters.