PivotField.IncludeNewItemsInFilter Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Позволяет разработчикам указать, следует ли отслеживать исключенные или включенные элементы при применении к фильтру PivotFieldвручную. Для чтения и записи.
public:
property bool IncludeNewItemsInFilter { bool get(); void set(bool value); };public bool IncludeNewItemsInFilter { get; set; }Public Property IncludeNewItemsInFilter As 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 объекта . Переключение этого параметра не изменит состояние фильтра.