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
注解
此属性的默认值为 False 。
应用手动筛选时，开发人员可以将 属性设置为 IncludeNewItemsInFilterTrue 以跟踪排除的项。 他们可以将 属性设置为 False 以跟踪包含的项。
如果在 属性设置为 True 后IncludeNewItemsInFilter将新项目添加到源数据中，则下一次刷新操作后，新项目将显示在 PivotTable 中，因为它们不在 Excel 正在跟踪的项目集合中。
对于 OLAP 层次结构，此设置是在 对象上设置的 CubeField ，尝试在属于层次结构的 的 上 PivotField设置此设置将失败 (，并) 出现运行时错误。 可以从属于层次结构的 的 PivotField中获取此设置，它将返回与相应 IncludeNewItemsInFilter 属性相同的 。
切换此设置将清除以下集合： HiddenItemsList、 HiddenItems[Object]、 VisibleItemsList和 VisibleItems[Object]。
当 设置为 False 时IncludeNewItemsInFilter， HiddenItemsList 和 HiddenItems[Object] 集合为空，并且无法向其添加项。 试图添加项目时会返回运行时错误。
当 设置为 True 时VisibleItemsListIncludeNewItemsInFilter， 和 VisibleItems[Object] 集合为空，并且无法向其添加项。 试图添加项目时会返回运行时错误。
在 PivotTable中，此设置是在 对象上设置的 PivotField 。 切换此设置将不会改变筛选器状态。