Создание встречи, которая повторяется по недельному расписанию
В этом примере показывается создание повторяющейся встречи, которая имеет недельное расписание (например, встречи, которая происходит каждые понедельник, среду и пятницу).
Пример
Примечание.
Приведенный ниже пример кода представляет собой фрагмент из книги Программирование приложений для Microsoft Office Outlook 2007.
При создании повторяющейся встречи основой расписания повторения является время, которое задается при создании встречи. Например, при создании встречи, повторяющейся каждый день в 13:00, она будет ежедневно повторяться только в 13:00. Чтобы изменить расписание повторения встречи, задайте свойства объекта RecurrencePattern для встречи. Задайте свойство RecurrenceType объекта RecurrencePattern до назначения других свойств RecurrencePattern. В следующей таблице показаны допустимые свойства RecurrencePattern для заданного RecurrenceType (определяется перечислением OlRecurrenceType).
Значение OlRecurrenceType |
Допустимые свойства RecurrencePattern |
|---|---|
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) на один из вышеупомянутых объектов, новая ссылка будет продолжать указывать на устаревшую копию объекта. Поэтому важно удалять ссылки сразу же по окончании работы с повторяющейся встречей.
В представленном ниже примере кода RecurringAppointmentEveryMondayWednesdayFriday создает объект AppointmentItem, а затем вызывает GetRecurrencePattern(), чтобы получить вновь созданный объект RecurrencePattern для встречи. Затем RecurringAppointmentEveryMondayWednesdayFriday задает свойства RecurrenceType, DayOfWeekMask, PatternStartDate, PatternEndDate, Duration, StartTime, EndTime и Subject, сохраняет встречу и отображает ее с расписанием "Происходит каждый понедельник, среду и пятницу, начиная с 7.10.2006 по 8.25.2006 с 14:00 до 15:00".
Если вы используете Visual Studio для тестирования этого примера кода, сначала добавьте ссылку на компонент Microsoft Outlook 15.0 Object Library и задайте переменную Outlook при импорте пространства имен Microsoft.Office.Interop.Outlook. Инструкция using не должна находиться непосредственно перед функциями в примере кода, но ее нужно добавить перед объявлением общедоступного класса. В следующей строке кода показано, как выполнить импорт и назначение в C#.
using Outlook = Microsoft.Office.Interop.Outlook;
private void RecurringAppointmentEveryMondayWednesdayFriday()
{
Outlook.AppointmentItem appt = Application.CreateItem(
Outlook.OlItemType.olAppointmentItem)
as Outlook.AppointmentItem;
appt.Subject = "Recurring Appointment DaysOfWeekMask Example";
Outlook.RecurrencePattern pattern = appt.GetRecurrencePattern();
pattern.RecurrenceType = Outlook.OlRecurrenceType.olRecursWeekly;
// Logical OR for DayOfWeekMask creates pattern
pattern.DayOfWeekMask = Outlook.OlDaysOfWeek.olMonday |
Outlook.OlDaysOfWeek.olWednesday |
Outlook.OlDaysOfWeek.olFriday;
pattern.PatternStartDate = DateTime.Parse("7/10/2006");
pattern.PatternEndDate = DateTime.Parse("8/25/2006");
pattern.Duration = 60;
pattern.StartTime = DateTime.Parse("2:00:00 PM");
pattern.EndTime = DateTime.Parse("3:00:00 PM");
appt.Save();
appt.Display(false);
}