Share via

PivotField.IncludeNewItemsInFilter Свойство

  • Ссылка

Определение

Пространство имен:
Microsoft.Office.Interop.Excel
Сборка:
Microsoft.Office.Interop.Excel.dll

Позволяет разработчикам указать, следует ли отслеживать исключенные или включенные элементы при применении к фильтру PivotFieldвручную. Для чтения и записи.

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

Значение свойства

Boolean

Boolean

Комментарии

Значение по умолчанию для этого свойства — False.

При применении ручной фильтрации разработчики могут задать IncludeNewItemsInFilter для свойства значение True для отслеживания исключенных элементов. Для отслеживания включенных элементов для свойства можно задать значение False .

Если новые элементы добавляются в исходные данные после IncludeNewItemsInFilter того, как свойство имеет значение True, новые элементы отображаются в PivotTable после следующей операции обновления, так как они не находятся в коллекции элементов, отслеживаемых Excel.

Для иерархий OLAP этот параметр задается в объекте CubeField , и попытка задать его на PivotFields, которые являются частью иерархии, завершится ошибкой (с ошибкой во время выполнения). Этот параметр можно получить из PivotFieldэлементов , которые являются частью иерархии, и он вернет то же, что и соответствующее IncludeNewItemsInFilter свойство.

Переключение этого параметра приведет к очистке следующих коллекций: HiddenItemsList, HiddenItems[Object], VisibleItemsListи VisibleItems[Object].

Если IncludeNewItemsInFilter задано значение False, HiddenItemsList коллекции и HiddenItems[Object] являются пустыми, и элементы не могут быть добавлены в них. При попытке добавить элементы возвращается ошибка времени выполнения.

Если IncludeNewItemsInFilter задано значение True, VisibleItemsList коллекции и VisibleItems[Object] являются пустыми и элементы не могут быть добавлены в них. При попытке добавить элементы возвращается ошибка времени выполнения.

В PivotTableпараметрах этот параметр задается для PivotField объекта . Переключение этого параметра не изменит состояние фильтра.

Применяется к