PivotField.IncludeNewItemsInFilter 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

允许开发人员指定在对应用 PivotField手动筛选时是否应跟踪排除项或包含项。读/写。

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

public bool IncludeNewItemsInFilter { get; set; }

Public Property IncludeNewItemsInFilter As Boolean

Boolean

Boolean

此属性的默认值为 False 。

应用手动筛选时，开发人员可以将属性设置为 IncludeNewItemsInFilterTrue 以跟踪排除的项。他们可以将属性设置为 False 以跟踪包含的项。

如果在属性设置为 True 后IncludeNewItemsInFilter将新项目添加到源数据中，则下一次刷新操作后，新项目将显示在 PivotTable 中，因为它们不在 Excel 正在跟踪的项目集合中。

对于 OLAP 层次结构，此设置是在对象上设置的 CubeField ，尝试在属于层次结构的的上 PivotField设置此设置将失败 (，并) 出现运行时错误。可以从属于层次结构的的 PivotField中获取此设置，它将返回与相应 IncludeNewItemsInFilter 属性相同的。

当设置为 False 时IncludeNewItemsInFilter， HiddenItemsList 和 HiddenItems[Object] 集合为空，并且无法向其添加项。试图添加项目时会返回运行时错误。

当设置为 True 时VisibleItemsList IncludeNewItemsInFilter，和 VisibleItems[Object] 集合为空，并且无法向其添加项。试图添加项目时会返回运行时错误。

在 PivotTable中，此设置是在对象上设置的 PivotField 。切换此设置将不会改变筛选器状态。