Объект 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 |
Свойства
См. также
Эталонное повторение объектной модели Outlook, члены объектаPattern
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.