Управление повторениями

Contents
[ ]

Работа с ежедневными повторениями

Aspose.Email поддерживает создание ежедневных повторений с использованием MapiCalendarDailyRecurrencePattern. Можно использовать три различных типа завершения повторения календаря Mapi, включая EndAfterNOccurrences, EndAfterDate и NeverEnd. Этот раздел демонстрирует создание различных шаблонов ежедневных повторений.

Ежедневные повторения с количеством повторений

В этом типе повторения количество повторений должно быть задано вместе с другой информацией, как показано ниже:

  1. Установите дату начала, окончания и дедлайн.
  2. Создать MapiTask.
  3. Установить состояние задачи в NotAssigned.
  4. Создайте объект ежедневного повторения, задав свойства, такие как PatternType, Period, WeekStartDay, EndType и OccurenceCount.
  5. Установите свойство MapiTask.Recurrence в этот объект ежедневного повторения.
  6. Сохраните это сообщение на диск.

Следующий фрагмент кода показывает, как создать задачу с типом окончания повторения EndAfterNOccurrence.

// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook();

TimeZone localZone = TimeZone.CurrentTimeZone;
TimeSpan timeSpan = localZone.GetUtcOffset(DateTime.Now);
DateTime StartDate = new DateTime(2015, 7, 16);
StartDate = StartDate.Add(timeSpan);

DateTime DueDate = new DateTime(2015, 7, 16);
DateTime endByDate = new DateTime(2015, 8, 1);
DueDate = DueDate.Add(timeSpan);
endByDate = endByDate.Add(timeSpan);
 
MapiTask task = new MapiTask("This is test task", "Sample Body", StartDate, DueDate);
task.State = MapiTaskState.NotAssigned;

// Set the Daily recurrence
var rec = new MapiCalendarDailyRecurrencePattern
{
    PatternType = MapiCalendarRecurrencePatternType.Day,
    Period = 1,
    WeekStartDay = DayOfWeek.Sunday,
    EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=DAILY"),
};

if (rec.OccurrenceCount==0)
{
    rec.OccurrenceCount = 1;
}

task.Recurrence = rec;
task.Save(dataDir + "Daily_out.msg", TaskSaveFormat.Msg);

Следующая функция может быть использована для вычисления количества событий между двумя датами:

private static uint GetOccurrenceCount(DateTime start, DateTime endBy, string rrule)
{
    CalendarRecurrence pattern = new CalendarRecurrence(string.Format("DTSTART:{0}\r\nRRULE:{1}", start.ToString("yyyyMMdd"), rrule));
    DateCollection dates = pattern.GenerateOccurrences(start, endBy);
    return (uint)dates.Count;
}

Установка значения количества повторений

Следующий фрагмент кода показывает, как задать значение количества повторений.

// Set the Daily recurrence
var record = new MapiCalendarDailyRecurrencePattern
{
    PatternType = MapiCalendarRecurrencePatternType.Day,
    Period = 1,
    WeekStartDay = DayOfWeek.Sunday,
    EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
    OccurrenceCount = 5,
};
task.Recurrence = record;

Ежедневные повторения: тип EndAfterDate

Опция "End By" в задаче Mapi достигается установкой свойства OccurrenceCount, вычисляемого функцией GetOccurrenceCount(). Эта функция принимает дату начала, дату окончания и строку RRULE.

Ежедневные повторения: Установка значения Every Day

Следующий фрагмент кода показывает, как установить значение period в 1 и значение INTERVAL в 1 в строке RRULE.

// Set the Daily recurrence
var record = new MapiCalendarDailyRecurrencePattern
{
    PatternType = MapiCalendarRecurrencePatternType.Day,
    Period = 1,
    EndType = MapiCalendarRecurrenceEndType.EndAfterDate,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=DAILY;INTERVAL=1"),
    EndDate = endByDate
};

Значение Every Day можно установить в любое подходящее значение, как показано в следующем примере:


// Set the Daily recurrence
var record = new MapiCalendarDailyRecurrencePattern
{
	PatternType = MapiCalendarRecurrencePatternType.Day,
	Period = 2,
	EndType = MapiCalendarRecurrenceEndType.EndAfterDate,
	OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=DAILY;INTERVAL=2"),
};

Ежедневные повторения: тип NeverEnd

Тип завершения можно задать, используя MapiCalendarRecurrenceEndType.NeverEnd. Период или INTERVAL можно установить в требуемое значение, например 1, в следующем примере.

// Set the Daily recurrence
var record = new MapiCalendarDailyRecurrencePattern
{
    PatternType = MapiCalendarRecurrencePatternType.Day,
    Period = 1,
    EndType = MapiCalendarRecurrenceEndType.NeverEnd,
};

Работа с еженедельными повторениями

Aspose.Email предоставляет расширенные возможности для создания еженедельных повторений с использованием MapiCalendarWeeklyRecurrencePattern. Можно использовать три различных типа завершения повторения календаря Mapi, включая EndAfterNOccurrences, EndAfterDate и NeverEnd. Этот раздел демонстрирует создание различных шаблонов еженедельных повторений.

Еженедельные повторения: тип EndAfterNOccurrences

В этом типе повторения количество повторений должно быть задано вместе с другой информацией, как показано ниже:

  1. Установите дату начала, окончания и дедлайн.
  2. Создать MapiTask.
  3. Установить состояние задачи в NotAssigned.
  4. Создайте объект еженедельного повторения, задав свойства, такие как PatternType, Period, WeekStartDay, EndType и OccurenceCount.
  5. Установите свойство MapiTask.Recurrence в этот объект еженедельного повторения.
  6. Сохраните это сообщение на диск.

Следующий фрагмент кода показывает, как создать задачу с типом завершения повторения EndAfterNOccurrence.

// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook();
TimeZone localZone = TimeZone.CurrentTimeZone;
TimeSpan ts = localZone.GetUtcOffset(DateTime.Now);
DateTime StartDate = new DateTime(2015, 7, 16);
StartDate = StartDate.Add(ts);

DateTime DueDate = new DateTime(2015, 7, 16);
DateTime endByDate = new DateTime(2015, 9, 1);
DueDate = DueDate.Add(ts);
endByDate = endByDate.Add(ts);

MapiTask task = new MapiTask("This is test task", "Sample Body", StartDate, DueDate);
task.State = MapiTaskState.NotAssigned;

// Set the weekly recurrence
var rec = new MapiCalendarWeeklyRecurrencePattern
{
    EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
    PatternType = MapiCalendarRecurrencePatternType.Week,
    Period = 1,
    WeekStartDay = DayOfWeek.Sunday,
    DayOfWeek = MapiCalendarDayOfWeek.Friday,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=WEEKLY;BYDAY=FR"),
};

if (rec.OccurrenceCount == 0)
{
    rec.OccurrenceCount = 1;
}

task.Recurrence = rec;
task.Save(dataDir + "Weekly_out.msg", TaskSaveFormat.Msg);

Следующая функция может быть использована для вычисления количества событий между двумя датами:

private static uint GetOccurrenceCount(DateTime start, DateTime endBy, string rrule)
{            
    CalendarRecurrence pattern = new CalendarRecurrence(string.Format("DTSTART:{0}\r\nRRULE:{1}", start.ToString("yyyyMMdd"),rrule));            
    DateCollection dates = pattern.GenerateOccurrences(start, endBy);            
    return (uint)dates.Count;
}

Выбор нескольких дней недели

Следующий фрагмент кода показывает, как выбрать несколько дней недели.

// Set the weekly recurrence
var rec = new MapiCalendarWeeklyRecurrencePattern
{
    EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
    PatternType = MapiCalendarRecurrencePatternType.Week,
    Period = 1,
    WeekStartDay = DayOfWeek.Sunday,
    DayOfWeek = MapiCalendarDayOfWeek.Friday | MapiCalendarDayOfWeek.Monday,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=WEEKLY;BYDAY=FR,MO"),
};

Выбор нескольких дней недели и установка интервалов

Следующий фрагмент кода показывает, как выбрать несколько дней недели и задать интервалы.

// Set the weekly recurrence
var rec = new MapiCalendarWeeklyRecurrencePattern
{
    EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
    PatternType = MapiCalendarRecurrencePatternType.Week,
    Period = 2,
    WeekStartDay = DayOfWeek.Sunday,
    DayOfWeek = MapiCalendarDayOfWeek.Friday | MapiCalendarDayOfWeek.Monday,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=WEEKLY;BYDAY=FR,MO;INTERVAL=2"),
};

Еженедельные повторения: тип EndAfterDate

Опция "End By" в задаче Mapi достигается установкой свойства OccurrenceCount, вычисляемого функцией GetOccurrenceCount(). Эта функция принимает дату начала, дату окончания и строку RRULE.

Еженедельные повторения: Установка значения Every Day

Следующий фрагмент кода показывает, как установить значение period в 1 и значение INTERVAL в 1 в строке RRULE.

// Set the weekly recurrence
var rec = new MapiCalendarWeeklyRecurrencePattern
{
    EndType = MapiCalendarRecurrenceEndType.EndAfterDate,
    PatternType = MapiCalendarRecurrencePatternType.Week,
    Period = 1,
    WeekStartDay = DayOfWeek.Sunday,
    DayOfWeek = MapiCalendarDayOfWeek.Friday,
    EndDate = endByDate,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=WEEKLY;BYDAY=FR;INTERVAL=1"),
};

Значение Every Day можно установить в любое подходящее значение, а несколько дней можно выбрать, как показано в следующем примере:

var record = new MapiCalendarWeeklyRecurrencePattern
{
    EndType = MapiCalendarRecurrenceEndType.EndAfterDate,
    PatternType = MapiCalendarRecurrencePatternType.Week,
    Period = 2,
    WeekStartDay = DayOfWeek.Sunday,
    EndDate = endByDate,
    DayOfWeek = MapiCalendarDayOfWeek.Friday | MapiCalendarDayOfWeek.Monday,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=WEEKLY;BYDAY=FR,MO;INTERVAL=2"),
};

Еженедельные повторения: тип NeverEnd

Тип завершения можно задать, используя MapiCalendarRecurrenceEndType.NeverEnd. Период или INTERVAL можно установить в требуемое значение, например 1, в следующем примере.

// Set the weekly recurrence
var recurrence = new MapiCalendarWeeklyRecurrencePattern
{
    EndType = MapiCalendarRecurrenceEndType.NeverEnd,
    PatternType = MapiCalendarRecurrencePatternType.Week,
    Period = 1,
    WeekStartDay = DayOfWeek.Sunday,
    DayOfWeek = MapiCalendarDayOfWeek.Friday,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=WEEKLY;BYDAY=FR"),
};

Работа с ежемесячными повторениями

Aspose.Email поддерживает создание ежемесячных повторений с использованием MapiCalendarMonthlyRecurrencePattern. Можно использовать три различных типа завершения повторения календаря Mapi, включая EndAfterNOccurrences, EndAfterDate и NeverEnd. Этот раздел демонстрирует создание различных шаблонов ежемесячных повторений.

Ежемесячные повторения: тип EndAfterNOccurrences

В этом типе повторения количество повторений должно быть задано вместе с другой информацией, как показано ниже:

  1. Установите дату начала, окончания и дедлайн.
  2. Создать MapiTask.
  3. Установить состояние задачи в NotAssigned.
  4. Создайте объект ежемесячного повторения, задав свойства, такие как PatternType, Period, WeekStartDay, EndType и OccurenceCount.
  5. Установите свойство MapiTask.Recurrence в этот объект ежемесячного повторения.
  6. Сохраните это сообщение на диск.

Следующий фрагмент кода показывает, как создать задачу с типом завершения повторения EndAfterNOccurrence.

// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook();
TimeZone localZone = TimeZone.CurrentTimeZone;
TimeSpan ts = localZone.GetUtcOffset(DateTime.Now);
DateTime StartDate = new DateTime(2015, 7, 16);
StartDate = StartDate.Add(ts);

DateTime DueDate = new DateTime(2015, 7, 16);
DateTime endByDate = new DateTime(2015, 12, 31);
DueDate = DueDate.Add(ts);
endByDate = endByDate.Add(ts);

MapiTask task = new MapiTask("This is test task", "Sample Body", StartDate, DueDate);
task.State = MapiTaskState.NotAssigned;

// Set the Monthly recurrence
var rec = new MapiCalendarMonthlyRecurrencePattern
{
    Day = 15,
    Period = 1,
    PatternType = MapiCalendarRecurrencePatternType.Month,
    EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=MONTHLY;BYMONTHDAY=15;INTERVAL=1"),
    WeekStartDay = DayOfWeek.Monday,

};

if (rec.OccurrenceCount == 0)
{
    rec.OccurrenceCount = 1;
}

task.Recurrence = rec;
//task.Save(dataDir + "Monthly_out.msg", TaskSaveFormat.Msg);

Следующая функция может быть использована для вычисления количества событий между двумя датами:

private static uint GetOccurrenceCount(DateTime start, DateTime endBy, string rrule)
{
    CalendarRecurrence pattern = new CalendarRecurrence(string.Format("DTSTART:{0}\r\nRRULE:{1}", start.ToString("yyyyMMdd"), rrule));
    DateCollection dates = pattern.GenerateOccurrences(start, endBy);       
    return (uint)dates.Count;
}

Задать фиксированное количество повторений

Следующий фрагмент кода показывает, как задать фиксированное количество повторений.

// Set the Monthly recurrence
var records = new MapiCalendarMonthlyRecurrencePattern
{
    Day = 15,
    Period = 1,
    PatternType = MapiCalendarRecurrencePatternType.Month,
    EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
    OccurrenceCount = 5,
    WeekStartDay = DayOfWeek.Monday
};

Ежемесячные повторения: тип EndAfterDate

Опция "End By" в задаче Mapi достигается установкой свойства OccurrenceCount, вычисляемого функцией GetOccurrenceCount(). Эта функция принимает дату начала, дату окончания и строку RRULE. Следующий фрагмент кода показывает, как создать повторение 15-го числа каждого месяца между датой начала и датой окончания.

// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook();

TimeZone localZone = TimeZone.CurrentTimeZone;
TimeSpan ts = localZone.GetUtcOffset(DateTime.Now);
DateTime StartDate = new DateTime(2015, 7, 1);
StartDate = StartDate.Add(ts);

DateTime DueDate = new DateTime(2015, 7, 1);
DateTime endByDate = new DateTime(2015, 12, 31);
DueDate = DueDate.Add(ts);
endByDate = endByDate.Add(ts);

MapiTask task = new MapiTask("This is test task", "Sample Body", StartDate, DueDate);
task.State = MapiTaskState.NotAssigned;

// Set the Monthly recurrence
var recurrence = new MapiCalendarMonthlyRecurrencePattern
{
    Day = 15,
    Period = 1,
    PatternType = MapiCalendarRecurrencePatternType.Month,
    EndType = MapiCalendarRecurrenceEndType.EndAfterDate,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=MONTHLY;BYMONTHDAY=15;INTERVAL=1"),
    WeekStartDay = DayOfWeek.Monday,
    EndDate = endByDate
};

task.Recurrence = recurrence;
//task.Save(dataDir + "SetMonthlyEndAfterDateRecurrence_out.msg", TaskSaveFormat.Msg);

Ежемесячные повторения: тип NeverEnd

Следующий фрагмент кода показывает, как задать тип завершения, используя MapiCalendarRecurrenceEndType.NeverEnd.

var recurrence = new MapiCalendarMonthlyRecurrencePattern
{
    Day = 15,
    Period = 1,
    PatternType = MapiCalendarRecurrencePatternType.Month,
    EndType = MapiCalendarRecurrenceEndType.NeverEnd,
    WeekStartDay = DayOfWeek.Monday,
};

Работа с годовыми повторениями

Aspose.Email поддерживает создание годовых повторений с использованием MapiCalendarMonthlyRecurrencePattern. Установив свойство period в 12, мы получаем годовой шаблон повторения. Можно использовать три различных типа завершения повторения календаря Mapi, включая EndAfterNOccurrences, EndAfterDate и NeverEnd. Этот раздел демонстрирует создание различных шаблонов годовых повторений.

Годовые повторения: тип EndAfterNOccurrences

В этом типе повторения количество повторений должно быть задано вместе с другой информацией, как показано ниже:

  1. Установите дату начала, окончания и дедлайн.
  2. Создать MapiTask.
  3. Установить состояние задачи в NotAssigned.
  4. Создайте объект ежемесячного повторения, задав свойства, такие как PatternType, Period, WeekStartDay, EndType и OccurenceCount.
  5. Установите свойство MapiTask.Recurrence в этот объект ежемесячного повторения, чтобы получить годовое повторение.
  6. Сохраните это сообщение на диск.

Следующий фрагмент кода показывает, как создать задачу с типом завершения повторения EndAfterNOccurrence.


TimeZone localZone = TimeZone.CurrentTimeZone;
TimeSpan ts = localZone.GetUtcOffset(DateTime.Now);
DateTime StartDate = new DateTime(2015, 7, 1);
StartDate = StartDate.Add(ts);
DateTime DueDate = new DateTime(2015, 7, 1);
DateTime endByDate = new DateTime(2020, 12, 31);
DueDate = DueDate.Add(ts);
endByDate = endByDate.Add(ts);
MapiTask task = new MapiTask("This is test task", "Sample Body", StartDate, DueDate);
task.State = MapiTaskState.NotAssigned;

// Set the Yearly recurrence
var recurrence = new MapiCalendarMonthlyRecurrencePattern
{
	Day = 15,
	Period = 12,
	PatternType = MapiCalendarRecurrencePatternType.Month,
	EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
	OccurrenceCount = 3,
};
task.Recurrence = recurrence;
task.Save("Yearly.msg", TaskSaveFormat.Msg);

Годовые повторения: тип EndAfterDate

Опция "End By" в задаче Mapi достигается установкой свойства OccurrenceCount, вычисляемого функцией GetOccurrenceCount(). Эта функция принимает дату начала, дату окончания и строку RRULE. Следующий фрагмент кода показывает, как создать повторение 15-го числа каждого 7-го месяца между датой начала и датой окончания.

// Set the Yearly recurrence
var rec = new MapiCalendarMonthlyRecurrencePattern
{
    Day = 15,
    Period = 12,
    PatternType = MapiCalendarRecurrencePatternType.Month,
    EndType = MapiCalendarRecurrenceEndType.EndAfterDate,
    EndDate = endByDate,
    OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=YEARLY;BYMONTHDAY=15;BYMONTH=7;INTERVAL=1"),
};
task.Recurrence = rec;

Годовые повторения: тип NeverEnd

Следующий фрагмент кода показывает, как задать тип завершения, используя MapiCalendarRecurrenceEndType.NeverEnd.

// Set the Yearly recurrence
var recurrence = new MapiCalendarMonthlyRecurrencePattern
{
    Day = 15,
    Period = 12,
    PatternType = MapiCalendarRecurrencePatternType.Month,
    EndType = MapiCalendarRecurrenceEndType.NeverEnd,
};            

Генерация повторения из правила повторения

API Aspose.Email предоставляет возможность генерировать шаблон повторения из правила повторения (RRULE). Он разбирает информацию из RRULE в соответствии со спецификациями iCal RFC 5545 и генерирует шаблон повторения с помощью метода MapiCalendarRecurrencePatternFactory.FromString. Следующий фрагмент кода показывает, как создать шаблон повторения из правила повторения.

// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Outlook();

DateTime startDate = new DateTime(2015, 7, 16);
DateTime endDate = new DateTime(2015, 8, 1);
MapiCalendar app1 = new MapiCalendar("test location", "test summary", "test description", startDate, endDate);

app1.StartDate = startDate;
app1.EndDate = endDate;

string pattern = "DTSTART;TZID=Europe/London:20150831T080000\r\nDTEND;TZID=Europe/London:20150831T083000\r\nRRULE:FREQ=DAILY;INTERVAL=1;COUNT=7\r\nEXDATE:20150831T070000Z,20150904T070000Z";
app1.Recurrence.RecurrencePattern = MapiCalendarRecurrencePatternFactory.FromString(pattern);

Добавить вложение к повторяющимся календарным событиям

API Aspose.Email предоставляет возможность добавлять вложения к повторяющимся событиям календаря.

DateTime startDate = new DateTime(2018, 7, 19).AddHours(12);
MapiCalendar calendar = new MapiCalendar("location1", "summary1", "description1", startDate, startDate.AddHours(1));

MapiCalendarEventRecurrence recurrence = new MapiCalendarEventRecurrence();
MapiCalendarRecurrencePattern pattern = recurrence.RecurrencePattern = new MapiCalendarDailyRecurrencePattern();
pattern.PatternType = MapiCalendarRecurrencePatternType.Day;
pattern.Period = 1;
pattern.EndType = MapiCalendarRecurrenceEndType.NeverEnd;

DateTime exceptionDate = startDate.AddDays(3);
MapiCalendarExceptionInfo exception = new MapiCalendarExceptionInfo
{
    Location = "exceptionLoc",
    Subject = "exceptionSubj",
    Body = "exceptionBody",
    OriginalStartDate = exceptionDate,
    StartDateTime = exceptionDate,
    EndDateTime = exceptionDate.AddHours(5),
    Attachments = new MapiAttachmentCollection(calendar)
};
exception.Attachments.Add("file.txt", Encoding.ASCII.GetBytes("hello, world!"));

pattern.Exceptions.Add(exception);
pattern.ModifiedInstanceDates.Add(exceptionDate);
pattern.DeletedInstanceDates.Add(exceptionDate);
calendar.Recurrence = recurrence;

using (var newPst = PersonalStorage.Create(dataDir + "AddAttachmentToMapiExceptionInfo.pst", FileFormatVersion.Unicode))
{
    var newFolder = newPst.CreatePredefinedFolder("Calendar", StandardIpmFolder.Appointments);
    newFolder.AddMapiMessageItem(calendar);
}