Herhalingen beheren
Werken met dagelijkse herhalingen
Aspose.Email ondersteunt het maken van dagelijkse herhalingen met MapiCalendarDailyRecurrencePattern. Drie verschillende einde‑typen voor Mapi‑kalenderherhalingen kunnen worden gebruikt, namelijk EndAfterNOccurrences, EndAfterDate en NeverEnd. Deze sectie toont het maken van verschillende dagelijkse herhalingspatronen.
Dagelijkse herhalingen met aantal gebeurtenissen
Bij dit type herhaling moet het aantal herhalingen samen met andere informatie als volgt worden ingesteld:
- Stel start-, eind- en vervaldatum in.
- Maak een MapiTask aan.
- Stel de taakstatus in op NietToegewezen.
- Maak het dagelijkse herhalingsobject door de eigenschappen PatternType, Period, WeekStartDay, EndType en OccurenceCount in te stellen.
- Stel de eigenschap MapiTask.Recurrence in op dit dagelijkse herhalingsobject.
- Sla dit bericht op de schijf op.
Het onderstaande codefragment laat zien hoe u een taak maakt met herhalingseindtype 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);
De volgende functie kan worden gebruikt om het aantal evenementen tussen de twee data te berekenen:
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;
}
Het aantal herhalingen instellen
Het volgende codefragment laat zien hoe je de waarde voor het aantal herhalingen instelt.
// Set the Daily recurrence
var record = new MapiCalendarDailyRecurrencePattern
{
PatternType = MapiCalendarRecurrencePatternType.Day,
Period = 1,
WeekStartDay = DayOfWeek.Sunday,
EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
OccurrenceCount = 5,
};
task.Recurrence = record;
Dagelijkse herhalingen: EndAfterDate‑type
"Eind op"-optie in de Mapi-taak wordt bereikt door de OccurrenceCount-eigenschap in te stellen, berekend door de GetOccurrenceCount()‑functie. Deze functie neemt een startdatum, einddatum en RRULE-tekenreeks.
Dagelijkse herhalingen: De Elke Dag‑waarde instellen
Het volgende codefragment laat zien hoe je de period‑waarde op 1 en de INTERVAL‑waarde op 1 zet in de RRULE‑string.
// 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
};
De Every Day‑waarde kan op elke passende waarde worden gezet zoals in het volgende voorbeeld:
// Set the Daily recurrence
var record = new MapiCalendarDailyRecurrencePattern
{
PatternType = MapiCalendarRecurrencePatternType.Day,
Period = 2,
EndType = MapiCalendarRecurrenceEndType.EndAfterDate,
OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=DAILY;INTERVAL=2"),
};
Dagelijkse herhalingen: NeverEnd‑type
Het eindtype kan worden ingesteld met MapiCalendarRecurrenceEndType.NeverEnd. Periode of INTERVAL kan in het volgende voorbeeld op de vereiste waarde, bijvoorbeeld 1, worden gezet.
// Set the Daily recurrence
var record = new MapiCalendarDailyRecurrencePattern
{
PatternType = MapiCalendarRecurrencePatternType.Day,
Period = 1,
EndType = MapiCalendarRecurrenceEndType.NeverEnd,
};
Werken met wekelijkse herhalingen
Aspose.Email biedt uitgebreide mogelijkheden voor het maken van wekelijkse herhalingen met MapiCalendarWeeklyRecurrencePattern. Drie verschillende einde‑typen voor Mapi‑kalenderherhalingen kunnen worden gebruikt, namelijk EndAfterNOccurrences, EndAfterDate en NeverEnd. Deze sectie demonstreert het maken van verschillende wekelijkse herhalingspatronen.
Wekelijkse herhalingen: EndAfterNOccurrences‑type
Bij dit type herhaling moet het aantal herhalingen samen met andere informatie als volgt worden ingesteld:
- Stel start-, eind- en vervaldatum in.
- Maak een MapiTask aan.
- Stel de taakstatus in op NietToegewezen.
- Maak het wekelijks herhalingsobject door de eigenschappen zoals PatternType, Period, WeekStartDay, EndType en OccurenceCount in te stellen.
- Stel de eigenschap MapiTask.Recurrence in op dit wekelijks herhalingsobject.
- Sla dit bericht op de schijf op.
De volgende codefragment toont hoe u een taak maakt met eindtype van de herhaling als 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);
De volgende functie kan worden gebruikt om het aantal evenementen tussen de twee data te berekenen:
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;
}
Meerdere dagen in een week selecteren
Het volgende codefragment laat zien hoe je meerdere dagen in een week selecteert.
// 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"),
};
Meerdere dagen in een week selecteren en intervallen instellen
Het volgende codefragment laat zien hoe je meerdere dagen in een week selecteert en intervallen instelt.
// 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"),
};
Wekelijkse herhalingen: EndAfterDate‑type
"Eind op"-optie in de Mapi-taak wordt bereikt door de OccurrenceCount-eigenschap in te stellen, berekend door de GetOccurrenceCount()‑functie. Deze functie neemt een startdatum, einddatum en RRULE-tekenreeks.
Wekelijkse herhalingen: De Elke Dag‑waarde instellen
Het volgende codefragment laat zien hoe je de period‑waarde op 1 en de INTERVAL‑waarde op 1 zet in de RRULE‑string.
// 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"),
};
De Every Day‑waarde kan op elke passende waarde worden gezet en meerdere dagen kunnen worden geselecteerd zoals in het volgende voorbeeld:
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"),
};
Wekelijkse herhalingen: NeverEnd‑type
Het eindtype kan worden ingesteld met MapiCalendarRecurrenceEndType.NeverEnd. Periode of INTERVAL kan in het volgende voorbeeld op de vereiste waarde, bijvoorbeeld 1, worden gezet.
// 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"),
};
Werken met maandelijkse herhalingen
Aspose.Email ondersteunt het maken van maandelijkse herhalingen met MapiCalendarMonthlyRecurrencePattern. Drie verschillende einde‑typen voor Mapi‑kalenderherhalingen kunnen worden gebruikt, namelijk EndAfterNOccurrences, EndAfterDate en NeverEnd. Deze sectie toont het creëren van verschillende maandelijkse herhalingspatronen.
Maandelijkse herhalingen: EndAfterNOccurrences‑type
Bij dit type herhaling moet het aantal herhalingen samen met andere informatie als volgt worden ingesteld:
- Stel start-, eind- en vervaldatum in.
- Maak een MapiTask aan.
- Stel de taakstatus in op NietToegewezen.
- Maak het maandelijks herhalingsobject door de eigenschappen zoals PatternType, Period, WeekStartDay, EndType en OccurenceCount in te stellen.
- Stel de eigenschap MapiTask.Recurrence in op dit maandelijks herhalingsobject.
- Sla dit bericht op de schijf op.
De volgende codefragment toont hoe u een taak maakt met eindtype van de herhaling als 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);
De volgende functie kan worden gebruikt om het aantal evenementen tussen de twee data te berekenen:
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;
}
Stel vast aantal gebeurtenissen in
De volgende codefragment toont hoe u een vast aantal gebeurtenissen kunt instellen.
// Set the Monthly recurrence
var records = new MapiCalendarMonthlyRecurrencePattern
{
Day = 15,
Period = 1,
PatternType = MapiCalendarRecurrencePatternType.Month,
EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
OccurrenceCount = 5,
WeekStartDay = DayOfWeek.Monday
};
Maandelijkse herhalingen: EndAfterDate‑type
"Eind op"-optie in de Mapi-taak wordt bereikt door de OccurrenceCount-eigenschap in te stellen, berekend door de GetOccurrenceCount()‑functie. Deze functie neemt een startdatum, einddatum en RRULE-tekenreeks. Het volgende codefragment toont hoe u een herhaling maakt op de 15e van elke maand tussen de start‑ en einddatum.
// 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);
Maandelijkse herhalingen: NeverEnd‑type
Het volgende codefragment toont hoe u het eindtype instelt met MapiCalendarRecurrenceEndType.NeverEnd.
var recurrence = new MapiCalendarMonthlyRecurrencePattern
{
Day = 15,
Period = 1,
PatternType = MapiCalendarRecurrencePatternType.Month,
EndType = MapiCalendarRecurrenceEndType.NeverEnd,
WeekStartDay = DayOfWeek.Monday,
};
Werken met jaarlijkse herhalingen
Aspose.Email ondersteunt het maken van jaarlijkse herhalingen met MapiCalendarMonthlyRecurrencePattern. Door de period‑eigenschap op 12 te zetten, kunnen we een jaarlijks herhalingspatroon realiseren. Drie verschillende einde‑typen voor Mapi‑kalenderherhalingen kunnen worden gebruikt, namelijk EndAfterNOccurrences, EndAfterDate en NeverEnd. Deze sectie demonstreert het creëren van verschillende jaarlijkse herhalingspatronen.
Jaarlijkse herhalingen: EndAfterNOccurrences‑type
Bij dit type herhaling moet het aantal herhalingen samen met andere informatie als volgt worden ingesteld:
- Stel start-, eind- en vervaldatum in.
- Maak een MapiTask aan.
- Stel de taakstatus in op NietToegewezen.
- Maak het maandelijks herhalingsobject door de eigenschappen zoals PatternType, Period, WeekStartDay, EndType en OccurenceCount in te stellen.
- Stel de eigenschap MapiTask.Recurrence in op dit maandelijks herhalingsobject om de jaarlijkse herhaling te bereiken.
- Sla dit bericht op de schijf op.
De volgende codefragment toont hoe u een taak maakt met eindtype van de herhaling als 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);
Jaarlijkse herhalingen: EndAfterDate‑type
"Eind op"-optie in de Mapi-taak wordt bereikt door de OccurrenceCount-eigenschap in te stellen, berekend door de GetOccurrenceCount()‑functie. Deze functie neemt een startdatum, einddatum en RRULE-tekenreeks. Het volgende codefragment toont hoe u een herhaling maakt op de 15e van elke 7e maand tussen de start‑ en einddatum.
// 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;
Jaarlijkse herhalingen: NeverEnd‑type
Het volgende codefragment toont hoe u het eindtype instelt met MapiCalendarRecurrenceEndType.NeverEnd.
// Set the Yearly recurrence
var recurrence = new MapiCalendarMonthlyRecurrencePattern
{
Day = 15,
Period = 12,
PatternType = MapiCalendarRecurrencePatternType.Month,
EndType = MapiCalendarRecurrenceEndType.NeverEnd,
};
Herhaling genereren uit een herhalingsregel
Aspose.Email API biedt de mogelijkheid om een herhalingspatroon te genereren uit een Recurrence Rule (RRULE). Het analyseert de informatie uit de RRULE volgens de RFC 5545 iCal‑specificaties en genereert het herhalingspatroon met de methode MapiCalendarRecurrencePatternFactory.FromString. Het volgende codefragment toont hoe u een herhalingspatroon genereert uit een recurrences‑regel.
// 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);
Een bijlage toevoegen aan terugkerende agenda‑gebeurtenissen
Aspose.Email‑API biedt de mogelijkheid om bijlagen toe te voegen aan terugkerende agenda‑evenementen.
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);
}