مدیریت تکرارها

کار با تکرارهای روزانه

Aspose.Email از ایجاد تکرارهای روزانه با استفاده از MapiCalendarDailyRecurrencePattern پشتیبانی می‌کند. می‌توان از سه نوع پایان تکرار مختلف تقویم Mapi استفاده کرد که شامل EndAfterNOccurrences، EndAfterDate و NeverEnd می‌باشد. این بخش ایجاد الگوهای مختلف تکرار روزانه را نشان می‌دهد.

تکرارهای روزانه با شمارش وقوع

در این نوع تکرار، تعداد تکرارها به همراه سایر اطلاعات به شرح زیر تنظیم می‌شود:

1. تاریخ شروع، پایان و موعد را تنظیم کنید.
2. یک MapiTask ایجاد کنید.
3. وضعیت کار را به NotAssigned تنظیم کنید.
4. شیء تکرار روزانه را با تنظیم ویژگی‌هایی مانند PatternType، Period، WeekStartDay، EndType و OccurenceCount ایجاد کنید.
5. ویژگی MapiTask.Recurrence را به این شیء تکرار روزانه تنظیم کنید.
6. این پیام را بر روی دیسک ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه یک تسک با نوع پایان تکرار EndAfterNOccurrence ایجاد کنید.

تابع زیر می‌تواند برای محاسبه تعداد رویدادها بین دو تاریخ استفاده شود:

تنظیم مقدار تعداد وقوع‌ها

کد نمونه زیر نشان می‌دهد چگونه مقدار تعداد وقوع‌ها را تنظیم کنید.

تکرارهای روزانه: نوع EndAfterDate

"End By" گزینه در Mapi Task با تنظیم ویژگی OccurrenceCount که توسط تابع GetOccurrenceCount() محاسبه می‌شود، به‌دست می‌آید. این تابع تاریخ شروع، تاریخ پایان و رشته RRULE را دریافت می‌کند.

تکرارهای روزانه: تنظیم مقدار Every Day

کد نمونه زیر نشان می‌دهد چگونه مقدار period را به 1 و مقدار INTERVAL را نیز در رشته RRULE به 1 تنظیم کنیم.

مقدار Every Day می‌تواند به هر مقدار مناسب تنظیم شود همان‌طور که در مثال زیر نشان داده شده است:

تکرارهای روزانه: نوع NeverEnd

نوع پایان می‌تواند با استفاده از MapiCalendarRecurrenceEndType.NeverEnd تنظیم شود. مقدار Period یا INTERVAL را می‌توان در مثال زیر به مقدار مورد نیاز، مثلاً 1، تنظیم کرد.

کار با تکرارهای هفتگی

Aspose.Email امکانات گسترده‌ای برای ایجاد تکرارهای هفتگی با استفاده از MapiCalendarWeeklyRecurrencePattern فراهم می‌کند. می‌توان از سه نوع پایان تکرار مختلف تقویم Mapi استفاده کرد که شامل EndAfterNOccurrences، EndAfterDate و NeverEnd می‌باشد. این بخش ایجاد الگوهای مختلف تکرار هفتگی را نشان می‌دهد.

تکرارهای هفتگی: نوع EndAfterNOccurrences

در این نوع تکرار، تعداد تکرارها به همراه سایر اطلاعات به شرح زیر تنظیم می‌شود:

1. تاریخ شروع، پایان و موعد را تنظیم کنید.
2. یک MapiTask ایجاد کنید.
3. وضعیت کار را به NotAssigned تنظیم کنید.
4. شی تکرار هفتگی را با تنظیم ویژگی‌هایی مانند PatternType، Period، WeekStartDay، EndType و OccurenceCount ایجاد کنید.
5. ویژگی MapiTask.Recurrence را به این شی تکرار هفتگی تنظیم کنید.
6. این پیام را بر روی دیسک ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه یک کار با نوع پایان تکرار EndAfterNOccurrence ایجاد کنید.

تابع زیر می‌تواند برای محاسبه تعداد رویدادها بین دو تاریخ استفاده شود:

انتخاب چندین روز در یک هفته

کد نمونه زیر نشان می‌دهد چگونه چندین روز در یک هفته انتخاب کنید.

انتخاب چندین روز در یک هفته و تنظیم بازه‌ها

کد نمونه زیر نشان می‌دهد چگونه چندین روز در یک هفته را انتخاب کرده و بازه‌ها را تنظیم کنید.

تکرارهای هفتگی: نوع EndAfterDate

"End By" گزینه در Mapi Task با تنظیم ویژگی OccurrenceCount که توسط تابع GetOccurrenceCount() محاسبه می‌شود، به‌دست می‌آید. این تابع تاریخ شروع، تاریخ پایان و رشته RRULE را دریافت می‌کند.

تکرارهای هفتگی: تنظیم مقدار Every Day

کد نمونه زیر نشان می‌دهد چگونه مقدار period را به 1 و مقدار INTERVAL را نیز در رشته RRULE به 1 تنظیم کنیم.

مقدار Every Day می‌تواند به هر مقدار مناسب تنظیم شود و می‌توان چندین روز را همان‌طور که در مثال زیر نشان داده شده است انتخاب کرد:

تکرارهای هفتگی: نوع NeverEnd

نوع پایان می‌تواند با استفاده از MapiCalendarRecurrenceEndType.NeverEnd تنظیم شود. مقدار Period یا INTERVAL را می‌توان در مثال زیر به مقدار مورد نیاز، مثلاً 1، تنظیم کرد.

کار با تکرارهای ماهانه

Aspose.Email از ایجاد تکرارهای ماهانه با استفاده از MapiCalendarMonthlyRecurrencePattern پشتیبانی می‌کند. می‌توان از سه نوع پایان تکرار مختلف تقویم Mapi استفاده کرد که شامل EndAfterNOccurrences، EndAfterDate و NeverEnd می‌باشد. این بخش ایجاد الگوهای مختلف تکرار ماهانه را نشان می‌دهد.

تکرارهای ماهانه: نوع EndAfterNOccurrences

در این نوع تکرار، تعداد تکرارها به همراه سایر اطلاعات به شرح زیر تنظیم می‌شود:

1. تاریخ شروع، پایان و موعد را تنظیم کنید.
2. یک MapiTask ایجاد کنید.
3. وضعیت کار را به NotAssigned تنظیم کنید.
4. شی تکرار ماهانه را با تنظیم ویژگی‌هایی مانند PatternType، Period، WeekStartDay، EndType و OccurenceCount ایجاد کنید.
5. ویژگی MapiTask.Recurrence را به این شی تکرار ماهانه تنظیم کنید.
6. این پیام را بر روی دیسک ذخیره کنید.

قطعه کد زیر نشان می‌دهد چگونه یک کار با نوع پایان تکرار EndAfterNOccurrence ایجاد کنید.

تابع زیر می‌تواند برای محاسبه تعداد رویدادها بین دو تاریخ استفاده شود:

تنظیم تعداد ثابت وقوع‌ها

قطعه کد زیر نشان می‌دهد چگونه یک تعداد ثابت از وقوع‌ها را تنظیم کنید.

تکرارهای ماهانه: نوع EndAfterDate

"End By" گزینه در Mapi Task با تنظیم ویژگی OccurrenceCount که توسط تابع GetOccurrenceCount() محاسبه می‌شود، به‌دست می‌آید. این تابع تاریخ شروع، تاریخ پایان و رشته RRULE را دریافت می‌کند. قطعه کد زیر نشان می‌دهد چگونه یک تکرار در روز ۱۵ هر ماه بین تاریخ شروع و پایان ایجاد کنید.

تکرارهای ماهانه: نوع NeverEnd

قطعه کد زیر نشان می‌دهد چگونه نوع پایان را با استفاده از MapiCalendarRecurrenceEndType.NeverEnd تنظیم کنید.

کار با تکرارهای سالانه

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 ایجاد کنید.

تکرارهای سالانه: نوع EndAfterDate

"End By" گزینه در Mapi Task با تنظیم ویژگی OccurrenceCount که توسط تابع GetOccurrenceCount() محاسبه می‌شود، به‌دست می‌آید. این تابع تاریخ شروع، تاریخ پایان و رشته RRULE را دریافت می‌کند. قطعه کد زیر نشان می‌دهد چگونه یک تکرار در روز ۱۵ هر ۷ ماه بین تاریخ شروع و پایان ایجاد کنید.

تکرارهای سالانه: نوع NeverEnd

قطعه کد زیر نشان می‌دهد چگونه نوع پایان را با استفاده از MapiCalendarRecurrenceEndType.NeverEnd تنظیم کنید.

تولید تکرار از قاعده تکرار

API Aspose.Email قابلیت تولید الگوی تکرار از قانون تکرار (RRULE) را فراهم می‌کند. این API اطلاعات را طبق مشخصات iCal RFC 5545 از RRULE تجزیه‑تحلیل می‌کند و الگوی تکرار را با استفاده از متد MapiCalendarRecurrencePatternFactory.FromString تولید می‌نماید. قطعه کد زیر نشان می‌دهد چگونه الگوی تکرار را از قانون تکرار تولید کنید.

افزودن پیوست به رویدادهای تقویم تکراری

API Aspose.Email قابلیت افزودن پیوست‌ها به رویدادهای تقویم تکراری را فراهم می‌کند.