_Items.IncludeRecurrences Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает логическое значение (bool в C#), указывающее значение True , Items если коллекция должна включать шаблоны повторения. Для чтения и записи.
public:
property bool IncludeRecurrences { bool get(); void set(bool value); };
public bool IncludeRecurrences { get; set; }
Public Property IncludeRecurrences As Boolean
Значение свойства
Комментарии
Это свойство действует только в том случае, если коллекция Items содержит встречи и не отсортирована по свойству, отличному Start от возрастания. Значение по умолчанию — False. Используйте это свойство, если требуется получить все встречи для заданной даты, когда повторяющиеся встречи обычно не отображаются, так как они не связаны с какой-либо конкретной датой. Если вам нужно отсортировать и отфильтровать элементы встреч, которые содержат повторяющиеся встречи, это необходимо сделать в следующем порядке: отсортировать элементы по возрастанию, задать для параметра IncludeRecurrences значение True, а затем отфильтровать элементы. Пример кода, показывающий этот порядок, см. во втором примере ниже. Если коллекция включает повторяющиеся встречи без даты окончания, установка для свойства значения True может привести к бесконечному числу коллекций. Обязательно включите тест для этого в любой цикл. Не следует использовать свойство Count коллекции Items при итерации коллекции Items со свойством IncludeRecurrence , для которых задано значение True. Значение Count будет неопределенным.
Внимание! Фильтрация по отсортированного списка вхождений приведет к тому, что свойство IncludeRecurrences не будет работать должным образом. Например, следующая последовательность вернет все вхождения встреч. повторяющиеся и не повторяющиеся: (1) Сортировка по свойству Start (2) Задайте для свойства значение false (3) call Restrict (т. е. фильтр).