إدارة التكرارات

العمل مع التكرارات اليومية

يدعم Aspose.Email إنشاء التكرارات اليومية باستخدام MapiCalendarDailyRecurrencePattern. يمكن استخدام ثلاثة أنواع مختلفة من نهايات تكرار تقويم Mapi بما في ذلك EndAfterNOccurrences و EndAfterDate و NeverEnd. يوضح هذا القسم إنشاء أنماط تكرار يومية مختلفة.

التكرارات اليومية مع عدد الحدوث

في هذا النوع من التكرارات، يجب تعيين عدد التكرارات إلى جانب المعلومات الأخرى كما يلي:

1. عيّن تاريخ البدء، الانتهاء وتاريخ الاستحقاق.
2. إنشاء مهمة MapiTask.
3. تعيين حالة المهمة إلى غير مخصص.
4. أنشئ كائن التكرار اليومي عن طريق ضبط الخصائص مثل PatternType و Period و WeekStartDay و EndType و OccurenceCount.
5. عيّن خاصية MapiTask.Recurrence إلى كائن التكرار اليومي هذا.
6. احفظ هذه الرسالة على القرص.

يُظهر مقطع الشيفرة التالي كيفية إنشاء مهمة بنوع انتهاء التكرار EndAfterNOccurrence.

يمكن استخدام الدالة التالية لحساب عدد الأحداث بين التاريخين:

تعيين قيمة عدد التكرارات

يوضح مقتطف الشيفرة التالي كيفية تعيين قيمة عدد التكرارات.

التكرارات اليومية: نوع النهاية EndAfterDate

"End By" يُتحقق في مهمة Mapi عن طريق تعيين خاصية OccurrenceCount التي يتم حسابها بواسطة الدالة GetOccurrenceCount(). تأخذ هذه الدالة تاريخ البدء، تاريخ الانتهاء وسلسلة RRULE.

التكرارات اليومية: تعيين قيمة كل يوم

يوضح مقتطف الشيفرة التالي كيفية تعيين قيمة الفترة إلى 1 وقيمة INTERVAL إلى 1 في سلسلة RRULE كذلك.

يمكن تعيين قيمة Every Day إلى أي قيمة مناسبة كما هو موضح في المثال التالي:

التكرارات اليومية: نوع النهاية NeverEnd

يمكن تعيين نوع النهاية باستخدام MapiCalendarRecurrenceEndType.NeverEnd. يمكن تعيين Period أو INTERVAL إلى القيمة المطلوبة مثل 1 في المثال التالي.

العمل مع التكرارات الأسبوعية

يوفر Aspose.Email ميزات غنية لإنشاء تكرارات أسبوعية باستخدام MapiCalendarWeeklyRecurrencePattern. يمكن استخدام ثلاثة أنواع مختلفة من نهايات تكرار تقويم Mapi بما في ذلك EndAfterNOccurrences و EndAfterDate و NeverEnd. يوضح هذا القسم إنشاء أنماط تكرار أسبوعية مختلفة.

التكرارات الأسبوعية: نوع النهاية EndAfterNOccurrences

في هذا النوع من التكرارات، يجب تعيين عدد التكرارات إلى جانب المعلومات الأخرى كما يلي:

1. عيّن تاريخ البدء، الانتهاء وتاريخ الاستحقاق.
2. إنشاء مهمة MapiTask.
3. تعيين حالة المهمة إلى غير مخصص.
4. أنشئ كائن التكرار الأسبوعي عن طريق ضبط الخصائص مثل PatternType و Period و WeekStartDay و EndType و OccurenceCount.
5. عيّن خاصية MapiTask.Recurrence إلى كائن التكرار الأسبوعي هذا.
6. احفظ هذه الرسالة على القرص.

يوضح مقطع الكود التالي كيفية إنشاء مهمة بنوع نهاية تكرار EndAfterNOccurrence.

يمكن استخدام الدالة التالية لحساب عدد الأحداث بين التاريخين:

اختيار أيام متعددة في الأسبوع

يوضح مقتطف الشيفرة التالي كيفية اختيار أيام متعددة في الأسبوع.

اختيار أيام متعددة في الأسبوع وتعيين الفواصل

يوضح مقتطف الشيفرة التالي كيفية اختيار أيام متعددة في الأسبوع وتعيين الفواصل.

التكرارات الأسبوعية: نوع النهاية EndAfterDate

"End By" يُتحقق في مهمة Mapi عن طريق تعيين خاصية OccurrenceCount التي يتم حسابها بواسطة الدالة GetOccurrenceCount(). تأخذ هذه الدالة تاريخ البدء، تاريخ الانتهاء وسلسلة RRULE.

التكرارات الأسبوعية: تعيين قيمة كل يوم

يوضح مقتطف الشيفرة التالي كيفية تعيين قيمة الفترة إلى 1 وقيمة INTERVAL إلى 1 في سلسلة RRULE كذلك.

يمكن تعيين قيمة Every Day إلى أي قيمة مناسبة ويمكن اختيار أيام متعددة كما هو موضح في المثال التالي:

التكرارات الأسبوعية: نوع النهاية NeverEnd

يمكن تعيين نوع النهاية باستخدام MapiCalendarRecurrenceEndType.NeverEnd. يمكن تعيين Period أو INTERVAL إلى القيمة المطلوبة مثل 1 في المثال التالي.

العمل مع التكرارات الشهرية

يدعم Aspose.Email إنشاء تكرارات شهرية باستخدام MapiCalendarMonthlyRecurrencePattern. يمكن استخدام ثلاثة أنواع مختلفة من نهايات تكرار تقويم Mapi بما في ذلك EndAfterNOccurrences و EndAfterDate و NeverEnd. يوضح هذا القسم إنشاء أنماط تكرار شهرية مختلفة.

التكرارات الشهرية: نوع النهاية EndAfterNOccurrences

في هذا النوع من التكرارات، يجب تعيين عدد التكرارات إلى جانب المعلومات الأخرى كما يلي:

1. عيّن تاريخ البدء، الانتهاء وتاريخ الاستحقاق.
2. إنشاء مهمة MapiTask.
3. تعيين حالة المهمة إلى غير مخصص.
4. أنشئ كائن التكرار الشهري عن طريق ضبط الخصائص مثل PatternType و Period و WeekStartDay و EndType و OccurenceCount.
5. عيّن خاصية MapiTask.Recurrence إلى كائن التكرار الشهري هذا.
6. احفظ هذه الرسالة على القرص.

يوضح مقطع الكود التالي كيفية إنشاء مهمة بنوع نهاية تكرار EndAfterNOccurrence.

يمكن استخدام الدالة التالية لحساب عدد الأحداث بين التاريخين:

تعيين عدد ثابت من التكرارات

يوضح مقطع الكود التالي كيفية تعيين عدد ثابت من التكرارات.

التكرارات الشهرية: نوع النهاية EndAfterDate

"End By" يُتحقق في مهمة Mapi عن طريق تعيين خاصية OccurrenceCount التي يتم حسابها بواسطة الدالة GetOccurrenceCount(). تأخذ هذه الدالة تاريخ البدء، تاريخ الانتهاء وسلسلة RRULE. يوضح مقطع الكود التالي كيفية إنشاء تكرار في اليوم الـ 15 من كل شهر بين تاريخي البدء والانتهاء.

التكرارات الشهرية: نوع النهاية NeverEnd

يوضح مقطع الكود التالي كيفية تعيين نوع النهاية باستخدام MapiCalendarRecurrenceEndType.NeverEnd.

العمل مع التكرارات السنوية

يدعم Aspose.Email إنشاء تكرارات سنوية باستخدام MapiCalendarMonthlyRecurrencePattern. من خلال تعيين خاصية period إلى 12، يمكننا تحقيق نمط التكرار السنوي. يمكن استخدام ثلاثة أنواع مختلفة من نهايات تكرار تقويم Mapi بما في ذلك EndAfterNOccurrences و EndAfterDate و NeverEnd. يوضح هذا القسم إنشاء أنماط تكرار سنوية مختلفة.

التكرارات السنوية: نوع النهاية EndAfterNOccurrences

في هذا النوع من التكرارات، يجب تعيين عدد التكرارات إلى جانب المعلومات الأخرى كما يلي:

1. عيّن تاريخ البدء، الانتهاء وتاريخ الاستحقاق.
2. إنشاء مهمة MapiTask.
3. تعيين حالة المهمة إلى غير مخصص.
4. أنشئ كائن التكرار الشهري عن طريق ضبط الخصائص مثل PatternType و Period و WeekStartDay و EndType و OccurenceCount.
5. عيّن خاصية MapiTask.Recurrence إلى كائن التكرار الشهري هذا لتحقيق التكرار السنوي.
6. احفظ هذه الرسالة على القرص.

يوضح مقطع الكود التالي كيفية إنشاء مهمة بنوع نهاية تكرار EndAfterNOccurrence.

التكرارات السنوية: نوع النهاية EndAfterDate

"End By" يُتحقق في مهمة Mapi عن طريق تعيين خاصية OccurrenceCount التي يتم حسابها بواسطة الدالة GetOccurrenceCount(). تأخذ هذه الدالة تاريخ البدء، تاريخ الانتهاء وسلسلة RRULE. يوضح مقطع الكود التالي كيفية إنشاء تكرار في اليوم الـ 15 من كل شهر سابع بين تاريخي البدء والانتهاء.

التكرارات السنوية: نوع النهاية NeverEnd

يوضح مقطع الكود التالي كيفية تعيين نوع النهاية باستخدام MapiCalendarRecurrenceEndType.NeverEnd.

إنشاء تكرار من قاعدة التكرار

توفر Aspose.Email API القدرة على إنشاء نمط تكرار من قاعدة التكرار (RRULE). تقوم بتحليل المعلومات من RRULE وفقًا لمواصفات iCal RFC 5545 وتوليد نمط التكرار باستخدام الطريقة MapiCalendarRecurrencePatternFactory.FromString. يوضح مقطع الكود التالي كيفية توليد نمط التكرار من قاعدة التكرار.

إضافة مرفق إلى أحداث التقويم المتكررة

توفر واجهة برمجة تطبيقات Aspose.Email القدرة على إضافة مرفقات إلى أحداث التقويم المتكررة.