RecurrencePattern Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет шаблон частоты повторяющихся встреч и задач для связанного AppointmentItem объекта и TaskItem .
public interface class RecurrencePattern
[System.Runtime.InteropServices.Guid("00063044-0000-0000-C000-000000000046")]
public interface RecurrencePattern
Public Interface RecurrencePattern
- Атрибуты
Комментарии
Используйте метод GetRecurrencePattern , чтобы вернуть объект RecurrencePattern , связанный с объектом AppointmentItem или TaskItem .
Вызов Метода GetRecurrencePattern или ClearRecurrencePattern имеет побочный эффект установки свойства IsRecurring элемента соответствующим образом. Это свойство можно использовать по мере необходимости для эффективной Items фильтрации объекта.
Тип шаблона повторения указывается свойством RecurrenceType . Свойство RecurrenceType — это первое свойство, которое необходимо задать.
Следующие свойства допустимы для всех шаблонов повторения: EndTime, , OccurrencesStartDate, StartTimeили Type.
В следующей таблице показаны свойства, допустимые для различных типов повторений. Ошибка возникает, если элемент сохранен и свойство имеет значение NULL или содержит недопустимое значение. Шаблоны за месяц и год действительны только в течение одного дня. Еженедельные шаблоны допустимы только в качестве или .DayOfWeekMask
olRecursDaily | Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | |
olRecursWeekly | DayOfWeekMask, Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | |
olRecursMonthly | DayOfMonth, Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | |
olRecursMonthNth | DayOfWeekMask, Duration, EndTime, Interval, Instance, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | |
olRecursYearly | DayOfMonth, Duration, EndTime, Interval, MonthOfYear, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime | |
olRecursYearNth | DayOfWeekMask, Duration, EndTime, Interval, Instance, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime |
При работе с элементами повторяющихся встреч необходимо удалить все ранее существовавшие ссылки, получить новые ссылки на элемент повторяющейся встречи перед вызовом или изменением этого элемента и удалить эти ссылки сразу же по окончании внесения изменений и их сохранения. Эта практика применяется к повторяющимся AppointmentItem объектам и любому Exception объекту или RecurrencePattern . Чтобы удалить ссылки в Visual Basic, следует установить для этого существующего объекта значение Nothing. В C# следует явно освободить память для этого объекта.
Обратите внимание, что даже после высвобождения ссылки и попытки получения новой ссылки, если по-прежнему существует активная ссылка на любой из вышеупомянутых объектов, удерживаемая другой надстройкой или приложением Outlook, новая ссылка будет указывать на устаревшую копию объекта. В связи с этим важно высвобождать ссылки немедленно после завершения текущей встречи.
Свойства
Application |
Application Возвращает объект , представляющий родительское приложение Outlook для объекта . Только для чтения. |
Class |
Возвращает константу OlObjectClass , указывающую класс объекта. Только для чтения. |
DayOfMonth |
Возвращает или задает целое число (int в C#), указывающее день месяца, в котором происходит повторяющаяся встреча или задача. Для чтения и записи. |
DayOfWeekMask |
Возвращает или задает константу OlDaysOfWeek , представляющую маску для дней недели, в которых происходит повторяющаяся встреча или задача. Для чтения и записи. |
Duration |
Возвращает или задает целое число (int в C#), указывающее длительность (в минутах RecurrencePattern) объекта . Для чтения и записи. |
EndTime |
Возвращает или задает значение DateTime , указывающее время окончания для шаблона повторения. Для чтения и записи. |
Exceptions |
Возвращает коллекцию Exceptions для указанного ряда повторяющихся встреч. Только для чтения. |
Instance |
Возвращает или задает значение Integer (int в C#), указывающее число, для которого шаблон повторения действителен для заданного интервала. Для чтения и записи. |
Interval |
Возвращает или задает целое число (int в C#), указывающее количество единиц заданного типа повторения между вхождениями. Для чтения и записи. |
MonthOfYear |
Возвращает или задает значение Integer (int в C#), указывающее, какой месяц года допустим для указанного шаблона повторения. Для чтения и записи. |
NoEndDate |
Возвращает логическое значение (bool в C#), указывающее значение True, если шаблон повторения не имеет даты окончания. Для чтения и записи. |
Occurrences |
Возвращает или задает целое число (int в C#), указывающее количество вхождений шаблона повторения. Для чтения и записи. |
Parent |
Возвращает родительский объект указанного объекта. Только для чтения. |
PatternEndDate |
Возвращает или задает значение DateTime , указывающее дату окончания для шаблона повторения. Для чтения и записи. |
PatternStartDate |
Возвращает или задает значение DateTime , указывающее дату начала для шаблона повторения. Для чтения и записи. |
RecurrenceType |
Возвращает или задает константу OlRecurrenceType , указывающую частоту вхождений для шаблона повторения. Для чтения и записи. |
Regenerate |
Возвращает логическое значение (bool в C#), указывающее значение True , если задача должна быть повторно создана после этого прохождения через шаблон повторения. Для чтения и записи. |
Session |
NameSpace Возвращает объект для текущего сеанса. Только для чтения. |
StartTime |
Возвращает или задает значение DateTime , указывающее время начала для шаблона повторения. Для чтения и записи. |
Методы
GetOccurrence(DateTime) |
Возвращает конкретный экземпляр объекта на AppointmentItem указанную дату. |