Mengelola Pengulangan
Bekerja dengan Pengulangan Harian
Aspose.Email mendukung pembuatan pengulangan harian menggunakan MapiCalendarDailyRecurrencePattern. Tiga tipe akhir pengulangan kalender Mapi yang berbeda dapat digunakan termasuk EndAfterNOccurrences, EndAfterDate, dan NeverEnd. Bagian ini menunjukkan pembuatan pola pengulangan harian yang berbeda.
Pengulangan Harian dengan Jumlah Kejadian
Dalam tipe pengulangan ini, jumlah pengulangan harus diatur bersama informasi lain sebagai berikut:
- Atur tanggal mulai, selesai, dan jatuh tempo.
- Buat MapiTask.
- Atur status tugas menjadi NotAssigned.
- Buat objek pengulangan harian dengan mengatur properti seperti PatternType, Period, WeekStartDay, EndType, dan OccurenceCount.
- Set properti MapiTask.Recurrence ke objek pengulangan harian ini.
- Simpan pesan ini di disk.
Potongan kode berikut menunjukkan cara membuat tugas dengan tipe akhir pengulangan 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);
Fungsi berikut dapat digunakan untuk menghitung jumlah acara antara dua tanggal:
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;
}
Mengatur Nilai Jumlah Kejadian
Potongan kode berikut menunjukkan cara mengatur nilai jumlah kejadian.
// Set the Daily recurrence
var record = new MapiCalendarDailyRecurrencePattern
{
PatternType = MapiCalendarRecurrencePatternType.Day,
Period = 1,
WeekStartDay = DayOfWeek.Sunday,
EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
OccurrenceCount = 5,
};
task.Recurrence = record;
Pengulangan Harian: Tipe EndAfterDate
"End By" opsi dalam Mapi Task dicapai dengan mengatur properti OccurrenceCount yang dihitung oleh fungsi GetOccurrenceCount(). Fungsi ini menerima tanggal mulai, tanggal akhir, dan string RRULE.
Pengulangan Harian: Menetapkan nilai Setiap Hari
Potongan kode berikut menunjukkan cara mengatur nilai period menjadi 1 dan nilai INTERVAL menjadi 1 dalam string RRULE juga.
// 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
};
Nilai Every Day dapat diatur ke nilai yang sesuai seperti pada contoh berikut:
// Set the Daily recurrence
var record = new MapiCalendarDailyRecurrencePattern
{
PatternType = MapiCalendarRecurrencePatternType.Day,
Period = 2,
EndType = MapiCalendarRecurrenceEndType.EndAfterDate,
OccurrenceCount = GetOccurrenceCount(StartDate, endByDate, "FREQ=DAILY;INTERVAL=2"),
};
Pengulangan Harian: Tipe NeverEnd
Tipe akhir dapat diatur dengan menggunakan MapiCalendarRecurrenceEndType.NeverEnd. Period atau INTERVAL dapat disetel ke nilai yang diperlukan, misalnya 1, pada contoh berikut.
// Set the Daily recurrence
var record = new MapiCalendarDailyRecurrencePattern
{
PatternType = MapiCalendarRecurrencePatternType.Day,
Period = 1,
EndType = MapiCalendarRecurrenceEndType.NeverEnd,
};
Bekerja dengan Pengulangan Mingguan
Aspose.Email menyediakan fitur lengkap untuk pembuatan pengulangan mingguan menggunakan MapiCalendarWeeklyRecurrencePattern. Tiga tipe akhir pengulangan kalender Mapi yang berbeda dapat digunakan termasuk EndAfterNOccurrences, EndAfterDate, dan NeverEnd. Bagian ini menunjukkan pembuatan pola pengulangan mingguan yang berbeda.
Pengulangan Mingguan: Tipe EndAfterNOccurrences
Dalam tipe pengulangan ini, jumlah pengulangan harus diatur bersama informasi lain sebagai berikut:
- Atur tanggal mulai, selesai, dan jatuh tempo.
- Buat MapiTask.
- Atur status tugas menjadi NotAssigned.
- Buat objek pengulangan mingguan dengan mengatur properti seperti PatternType, Period, WeekStartDay, EndType, dan OccurenceCount.
- Atur properti MapiTask.Recurrence ke objek pengulangan mingguan ini.
- Simpan pesan ini di disk.
Potongan kode berikut menunjukkan cara membuat tugas dengan tipe akhir pengulangan 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);
Fungsi berikut dapat digunakan untuk menghitung jumlah acara antara dua tanggal:
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;
}
Memilih Beberapa Hari dalam Seminggu
Potongan kode berikut menunjukkan cara memilih beberapa hari dalam seminggu.
// 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"),
};
Memilih Beberapa Hari dalam Seminggu dan Mengatur Interval
Potongan kode berikut menunjukkan cara memilih beberapa hari dalam seminggu dan mengatur interval.
// 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"),
};
Pengulangan Mingguan: Tipe EndAfterDate
"End By" opsi dalam Mapi Task dicapai dengan mengatur properti OccurrenceCount yang dihitung oleh fungsi GetOccurrenceCount(). Fungsi ini menerima tanggal mulai, tanggal akhir, dan string RRULE.
Pengulangan Mingguan: Menetapkan nilai Setiap Hari
Potongan kode berikut menunjukkan cara mengatur nilai period menjadi 1 dan nilai INTERVAL menjadi 1 dalam string RRULE juga.
// 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"),
};
Nilai Every Day dapat diatur ke nilai yang sesuai dan beberapa hari dapat dipilih seperti pada contoh berikut:
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"),
};
Pengulangan Mingguan: Tipe NeverEnd
Tipe akhir dapat diatur dengan menggunakan MapiCalendarRecurrenceEndType.NeverEnd. Period atau INTERVAL dapat disetel ke nilai yang diperlukan, misalnya 1, pada contoh berikut.
// 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"),
};
Bekerja dengan Pengulangan Bulanan
Aspose.Email mendukung pembuatan pengulangan bulanan menggunakan MapiCalendarMonthlyRecurrencePattern. Tiga tipe akhir pengulangan kalender Mapi yang berbeda dapat digunakan termasuk EndAfterNOccurrences, EndAfterDate, dan NeverEnd. Bagian ini menunjukkan pembuatan pola pengulangan bulanan yang berbeda.
Pengulangan Bulanan: Tipe EndAfterNOccurrences
Dalam tipe pengulangan ini, jumlah pengulangan harus diatur bersama informasi lain sebagai berikut:
- Atur tanggal mulai, selesai, dan jatuh tempo.
- Buat MapiTask.
- Atur status tugas menjadi NotAssigned.
- Buat objek pengulangan bulanan dengan mengatur properti seperti PatternType, Period, WeekStartDay, EndType, dan OccurenceCount.
- Atur properti MapiTask.Recurrence ke objek pengulangan bulanan ini.
- Simpan pesan ini di disk.
Potongan kode berikut menunjukkan cara membuat tugas dengan tipe akhir pengulangan 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);
Fungsi berikut dapat digunakan untuk menghitung jumlah acara antara dua tanggal:
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;
}
Tetapkan jumlah kejadian tetap
Potongan kode berikut menunjukkan cara menetapkan jumlah kejadian tetap.
// Set the Monthly recurrence
var records = new MapiCalendarMonthlyRecurrencePattern
{
Day = 15,
Period = 1,
PatternType = MapiCalendarRecurrencePatternType.Month,
EndType = MapiCalendarRecurrenceEndType.EndAfterNOccurrences,
OccurrenceCount = 5,
WeekStartDay = DayOfWeek.Monday
};
Pengulangan Bulanan: Tipe EndAfterDate
"End By" opsi dalam Mapi Task dicapai dengan mengatur properti OccurrenceCount yang dihitung oleh fungsi GetOccurrenceCount(). Fungsi ini menerima tanggal mulai, tanggal akhir, dan string RRULE. Potongan kode berikut menunjukkan cara membuat pengulangan pada tanggal 15 setiap bulan antara tanggal mulai dan akhir.
// 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);
Pengulangan Bulanan: Tipe NeverEnd
Potongan kode berikut menunjukkan cara mengatur tipe akhir menggunakan MapiCalendarRecurrenceEndType.NeverEnd.
var recurrence = new MapiCalendarMonthlyRecurrencePattern
{
Day = 15,
Period = 1,
PatternType = MapiCalendarRecurrencePatternType.Month,
EndType = MapiCalendarRecurrenceEndType.NeverEnd,
WeekStartDay = DayOfWeek.Monday,
};
Bekerja dengan Pengulangan Tahunan
Aspose.Email mendukung pembuatan pengulangan tahunan menggunakan MapiCalendarMonthlyRecurrencePattern. Dengan mengatur properti period ke 12, kita dapat mencapai pola pengulangan tahunan. Tiga tipe akhir pengulangan kalender Mapi yang berbeda dapat digunakan termasuk EndAfterNOccurrences, EndAfterDate, dan NeverEnd. Bagian ini menunjukkan pembuatan pola pengulangan tahunan yang berbeda.
Pengulangan Tahunan: Tipe EndAfterNOccurrences
Dalam tipe pengulangan ini, jumlah pengulangan harus diatur bersama informasi lain sebagai berikut:
- Atur tanggal mulai, selesai, dan jatuh tempo.
- Buat MapiTask.
- Atur status tugas menjadi NotAssigned.
- Buat objek pengulangan bulanan dengan mengatur properti seperti PatternType, Period, WeekStartDay, EndType, dan OccurenceCount.
- Atur properti MapiTask.Recurrence ke objek pengulangan bulanan ini untuk mencapai pengulangan tahunan.
- Simpan pesan ini di disk.
Potongan kode berikut menunjukkan cara membuat tugas dengan tipe akhir pengulangan 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);
Pengulangan Tahunan: Tipe EndAfterDate
"End By" opsi dalam Mapi Task dicapai dengan mengatur properti OccurrenceCount yang dihitung oleh fungsi GetOccurrenceCount(). Fungsi ini menerima tanggal mulai, tanggal akhir, dan string RRULE. Potongan kode berikut menunjukkan cara membuat pengulangan pada tanggal 15 setiap bulan ke-7 antara tanggal mulai dan akhir.
// 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;
Pengulangan Tahunan: Tipe NeverEnd
Potongan kode berikut menunjukkan cara mengatur tipe akhir menggunakan MapiCalendarRecurrenceEndType.NeverEnd.
// Set the Yearly recurrence
var recurrence = new MapiCalendarMonthlyRecurrencePattern
{
Day = 15,
Period = 12,
PatternType = MapiCalendarRecurrencePatternType.Month,
EndType = MapiCalendarRecurrenceEndType.NeverEnd,
};
Hasilkan Pengulangan dari Aturan Pengulangan
API Aspose.Email menyediakan kemampuan untuk menghasilkan Pola Pengulangan dari Aturan Pengulangan (RRULE). Ia mengurai informasi dari RRULE sesuai spesifikasi iCal RFC 5545 dan menghasilkan pola pengulangan menggunakan metode MapiCalendarRecurrencePatternFactory.FromString. Potongan kode berikut menunjukkan cara menghasilkan pola pengulangan dari aturan pengulangan.
// 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);
Tambahkan Lampiran ke Acara Kalender Berulang
API Aspose.Email menyediakan kemampuan untuk menambahkan lampiran ke acara kalender berulang.
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);
}