Объект RecurrencePattern (Outlook)

  • Статья

Представляет шаблон частоты повторяющихся встреч и задач для связанных объектов AppointmentItem и TaskItem .

Замечания

Используйте метод GetRecurrencePattern , чтобы вернуть объект RecurrencePattern , связанный с объектом AppointmentItem или TaskItem .

Вызов Метода GetRecurrencePattern или ClearRecurrencePattern имеет побочный эффект установки свойства IsRecurring элемента соответствующим образом. Это свойство можно использовать по мере необходимости для эффективной фильтрации объекта Items .

Тип шаблона повторения указывается свойством RecurrenceType . Свойство RecurrenceType — это первое свойство, которое необходимо задать.

Следующие свойства допустимы для всех шаблонов повторения: EndTime, Occurrences, StartDate, StartTime или Type.

В следующей таблице показаны свойства, допустимые для различных типов повторений. Ошибка возникает, если элемент сохранен и свойство имеет значение NULL или содержит недопустимое значение. Шаблоны за месяц и год действительны только в течение одного дня. Еженедельные шаблоны действительны только как ordayOfWeekMask.

RecurrenceType Properties Примеры
olRecursDaily Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime Значение N для параметра Interval — каждые N дней.
olRecursWeekly DayOfWeekMask, Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime Значение N для параметра Interval имеет значение каждые N недель. Пример DayofWeekMask — каждый вторник, среду и четверг.
olRecursMonthly DayOfMonth, Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime Значение N для параметра Interval имеет значение каждые N месяцев. Значение N для DayofMonth — это каждый N-й день месяца.
olRecursMonthNth DayOfWeekMask, Duration, EndTime, Interval, Instance, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime Значение N для параметра Interval имеет значение каждые N месяцев. Примером значения N для экземпляра является каждый N-й вторник. Пример dayofWeekMask — каждый вторник и среду.
olRecursYearly DayOfMonth, Duration, EndTime, Interval, MonthOfYear, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime Значение N для DayofMonth — это N-й день месяца. Примером MonthOfYear является февраль.
olRecursYearNth DayOfWeekMask, Duration, EndTime, Interval, Instance, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime Примером значения N для экземпляра является N-й вторник. Пример dayofWeekMask — вторник, среда и четверг. Примером MonthOfYear является февраль.

При работе с элементами повторяющихся встреч необходимо удалить все ранее существовавшие ссылки, получить новые ссылки на элемент повторяющейся встречи перед вызовом или изменением этого элемента и удалить эти ссылки сразу же по окончании внесения изменений и их сохранения. Эта практика применяется к повторяющимся объекту AppointmentItem и любому объектуException или RecurrencePattern . Чтобы освободить ссылку в Visual Basic для приложений (VBA) или Visual Basic, задайте для этого существующего объекта значение Nothing. В C# следует явно освободить память для этого объекта. Пример кода см. в разделе объекта AppointmentItem .

Обратите внимание, что даже после высвобождения ссылки и попытки получения новой ссылки, если по-прежнему существует активная ссылка на любой из вышеупомянутых объектов, удерживаемая другой надстройкой или приложением Outlook, новая ссылка будет указывать на устаревшую копию объекта. В связи с этим важно высвобождать ссылки немедленно после завершения текущей встречи.

Методы

Имя
GetOccurrence

Свойства

Имя
Application
Class
DayOfMonth
DayOfWeekMask
Duration
EndTime
Exceptions
Instance
Interval
MonthOfYear
NoEndDate
Occurrences
Parent
PatternEndDate
PatternStartDate
RecurrenceType
Regenerate
Session
StartTime

См. также

Эталонное повторение объектной модели Outlook, члены объектаPattern

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.