Read and Create Outlook Items

تتناول هذه المقالة العمل مع عناصر Outlook المختلفة، بما في ذلك التقويمات، جهات الاتصال، المهام، السجل، الملاحظات، وقوائم التوزيع. في Aspose.Email لـ .NET، تمثل هذه العناصر بواسطة الفئات التالية: MapiCalendar، MapiContact، MapiTask، MapiJournal، MapiNote، و MapiDistributionList. تعمل هذه الفئات كغلاف لفئة MapiMessage لتبسيط عملية التعامل مع بيانات العناصر من خصائص MAPI، مما يوفر واجهة أكثر سهولة للوصول إلى بيانات العناصر والتلاعب بها.

API C# .NET لأداء المهام المتعلقة بالبريد الإلكتروني

للتعامل مع عناصر Outlook برمجياً في C#، سنستخدم Aspose.Email لـ .NET، المكتبة المتطورة التي تتيح لك بسهولة إدارة البريد الإلكتروني، جهات الاتصال، المواعيد، المهام، وعناصر Outlook الأخرى. تشمل بعض الميزات الرئيسية للمكتبة قراءة وكتابة رسائل البريد الإلكتروني في تنسيقات مختلفة، إدارة المواعيد والمهام، العمل مع جهات الاتصال، التكامل مع خادم Exchange، وأداء عمليات البريد الإلكتروني المتقدمة. في هذه المقالة، سنوضح كيفية استخدامها للتفاعل مع عناصر Outlook داخل تطبيقات .NET. يتم تقديم أمثلة عملية وقطع من التعليمات البرمجية لمساعدتك على فهم وتنفيذ وظائف Aspose.Email لـ .NET بسلاسة في مشاريع C# الخاصة بك.

للاستفادة من قوة API، يمكنك إما تنزيل DLL الخاص به أو تثبيته من NuGet باستخدام الأمر التالي:

PM> Install-Package Aspose.Email

النهج العام

يتضمن النهج العام للعمل مع عناصر Outlook تحميل MapiMessage، وتحويله إلى فئة عنصر Outlook معينة (مثل MapiContact أو MapiCalendar)، ثم الوصول إلى خصائصه أو التلاعب بها. يبسط هذا النهج العمل مع خصائص MAPI ويوفر وسيلة مباشرة لإدارة أنواع مختلفة من عناصر Outlook. من ناحية أخرى، يمكنك دائماً العودة إلى كائن MapiMessage ببساطة عن طريق استدعاء GetUnderlyingMessage على أي كائن عنصر.

التلاعب بعناصر التقويم

تمثل عناصر تقويم Outlook بواسطة فئة MapiCalendar. توفر الفئة خصائص وطرق لإنشاء والتلاعب وإدارة عناصر التقويم مثل المواعيد، الاجتماعات، والأحداث ضمن تقويم Outlook. يمكن للمستخدمين استخدام هذه الفئة بسهولة لإنشاء، تعديل، والتفاعل مع عناصر التقويم برمجياً في تطبيقاتهم .NET. في الفقرات التالية، ستتعلم كيفية إنشاء وقراءة عناصر التقويم.

قراءة عناصر التقويم

توضح عينة الكود أدناه كيفية تحميل ملف .msg ككائن MapiMessage. ثم تتحقق مما إذا كانت الرسالة المحملة من نوع التقويم باستخدام خاصية SupportedType. إذا كانت بالفعل عنصر تقويم، يقوم الكود بتحويل الرسالة إلى كائن MapiCalendar ويواصل إخراج تفاصيل عنصر التقويم.

فيما يلي خطوات الكود:

  1. تحميل الملف ككائن MapiMessage باستخدام طريقة Load.
  2. تحقق مما إذا كانت الرسالة المحملة من نوع التقويم.
  3. إذا كانت عنصر تقويم، قم بتحويل الرسالة إلى كائن MapiCalendar.
  4. إخراج الموقع، الموضوع، تاريخ البدء، وتاريخ الانتهاء لعنصر التقويم.

إنشاء عنصر تقويم

لإنشاء عنصر تقويم جديد وحفظه بتنسيقات مختلفة، استخدم عينة الكود التالية المقدمة من Aspose.Email:

  1. إنشاء عنصر تقويم جديد MapiCalendar مع تفاصيل محددة مثل الموقع، الموضوع، الوصف، وقت البدء، ووقت الانتهاء.
  2. استدعاء طريقة Save على كائن التقويم مع المعلمات التي تحدد اسم ملف الإخراج وخيارات الحفظ. يتم حفظ عنصر التقويم كملف ICS (iCalendar) مع الامتداد “.ics” باستخدام MapiCalendarSaveOptions.DefaultIcs.
  3. بالمثل، يتم استدعاء طريقة Save مرة أخرى على كائن التقويم لحفظ عنصر التقويم كملف MSG (رسالة Outlook) مع الامتداد “.msg” باستخدام MapiCalendarSaveOptions.DefaultMsg.

التلاعب بعناصر الاتصال

تقدم Aspose.Email فئة MapiContact المستخدمة للعمل مع عناصر الاتصال في Microsoft Outlook. تتيح هذه الفئة للمطورين إنشاء، قراءة، تحديث، والتلاعب بجهات الاتصال في Outlook بتنسيقات مختلفة مثل MSG وVCF. توفر هذه الفئة خصائص وطرق لتعيين واسترجاع معلومات الاتصال، بما في ذلك الاسم، عنوان البريد الإلكتروني، أرقام الهواتف، المسمى الوظيفي، الشركة، وغيرها من تفاصيل الاتصال.

توضح عينات الكود أدناه كيفية استخدام فئة MapiContact في إنشاء وقراءة جهات الاتصال.

قراءة عناصر الاتصال

تشمل عملية قراءة عنصر اتصال تحميل رسالة اتصال من ملف رسالة MAPI وعرض تفاصيل الاتصال:

  1. تحميل MapiMessage من ملف باستخدام MapiMessage.Load.
  2. تحقق مما إذا كانت النوع المدعوم لـ MapiMessage هو اتصال.
  3. إذا كان اتصالاً، قم بتحويل MapiMessage إلى كائن MapiContact.
  4. عرض تفاصيل الاسم، البريد الإلكتروني، والشركة للاتصال.

إنشاء عنصر اتصال

دعنا ننشئ اتصالاً جديداً باستخدام فئة MapiContact، ونقوم بتعيين خصائص مختلفة مثل الاسم، عنوان البريد الإلكتروني، ومعلومات الشركة، ثم حفظ تفاصيل الاتصال بتنسيق VCARD وMSG.

تشمل العملية الخطوات التالية:

  1. إنشاء كائن MapiContact جديد وت初始化 خصائصه بما في ذلك الاسم، عنوان البريد الإلكتروني، ومعلومات الشركة.
  2. حفظ تفاصيل الاتصال بتنسيق VCARD باستخدام طريقة Save مع معامل ContactSaveFormat.VCard.
  3. حفظ تفاصيل الاتصال بتنسيق MSG باستخدام طريقة Save مع معامل ContactSaveFormat.Msg.

التلاعب بعناصر المهام

تقدم Aspose.Email حلاً لإدارة مهام Outlook بكفاءة. تعد فئة MapiTask خيارًا ممتازًا لإنشاء وقراءة المهام بسلاسة. دعنا نرى كيف تعمل هذه الفئة في الكود.

قراءة عناصر المهام

للوصول إلى عناصر المهام والتلاعب بها، قم بتحميل واحدة من ملف باستخدام MapiMessage.Load. مع بضع أسطر من الكود، يمكنك استرجاع تفاصيل المهام المهمة مثل الموضوع، الحالة، ونسبة الاكتمال.

  1. تحميل مهمة من الملف باستخدام MapiMessage.Load.
  2. تحقق مما إذا كانت الرسالة المحملة من نوع MapiItemType Task.
  3. إذا كانت الرسالة مهمة، قم بتحويلها إلى نوع MapiTask.
  4. عرض تفاصيل المهمة من خلال طباعة الموضوع، الحالة، ونسبة الاكتمال.

إنشاء عنصر مهمة

توضح عينة الكود التالية كيفية إنشاء عنصر مهمة، تعيين خصائصه مثل العنوان، الوصف، تواريخ البدء والانتهاء، نسبة الاكتمال، والحالة، وحفظه كملف MSG:

  1. إنشاء كائن مهمة جديد باستخدام فئة MapiTask مع تفاصيل محددة مثل العنوان، الوصف، تاريخ البدء، تاريخ الانتهاء، نسبة الاكتمال، والحالة.
  2. تعيين خاصية PercentComplete للمهمة وخاصية Status.
  3. حفظ المهمة التي تم إنشاؤها في ملف MSG باستخدام طريقة Save مع TaskSaveFormat.Msg كمعامل التنسيق.

إدارة عناصر السجل

تمثل إدخال السجل في Outlook بواسطة فئة MapiJournal. ستوجهك التعليمات التالية حول كيفية إنشاء وقراءة إدخال سجل.

قراءة عنصر MapiJournal

لقراءة عنصر MapiJournal، يمكنك تحميل رسالة السجل باستخدام طريقة MapiMessage.Load. بعد التحقق من أن النوع المدعوم هو سجل، يمكنك استرجاع وعرض تفاصيل السجل مثل الموضوع، حالة الوثيقة، وقت البدء، ووقت الانتهاء.

  1. تحميل رسالة MAPI من الملف.
  2. تحقق مما إذا كان النوع المدعوم للرسالة المحملة هو عنصر سجل.
  3. إذا كانت الرسالة من نوع سجل، قم بتحويلها إلى كائن MapiJournal.
  4. إخراج تفاصيل السجل بما في ذلك الموضوع، الحالة، وقت البدء، ووقت الانتهاء.

إنشاء عنصر MapiJournal

الآن سنقوم بإنشاء إدخال سجل وتضمين التفاصيل. ستحتوي الإدخال أيضًا على وصف مختصر للاجتماع. توضح هذه الشيفرة كيفية إنشاء وحفظ MapiJournal.

  1. تعريف إدخال سجل جديد باستخدام فئة MapiJournal مع تفاصيل محددة مثل العنوان، الوصف، وصف الاجتماع، وملخص المناقشة.
  2. تعيين وقت البدء والانتهاء.
  3. تحديد الشركة وتصنيف الإدخال.
  4. حفظ إدخال السجل الذي تم إنشاؤه في ملف باستخدام طريقة Save.

إدارة عناصر الملاحظات

تقدم Aspose.Email فئة MapiNote التي تمثل ملاحظة Outlook. توفر حلاً لإنشاء واسترجاع معلومات الملاحظة بشكل فعال. دعنا نرى كيف تعمل.

قراءة عنصر ملاحظة

للوصول إلى تفاصيل الملاحظة وعرضها، قم بتحميل رسالة الملاحظة باستخدام MapiMessage.Load واسترجاع كائن الملاحظة. بعد ذلك، يمكنك الوصول وعرض تفاصيل محددة مثل الموضوع، الجسم، ولون الملاحظة لمزيد من المعالجة.

  1. تحميل MapiMessage من ملف.
  2. إذا كانت الرسالة المحملة من نوع الملاحظة، قم بتحويل MapiMessage إلى كائن MapiNote.
  3. طباعة الموضوع، الجسم، ولون كائن MapiNote المحول.

إنشاء عنصر ملاحظة

يمكن إنشاء ملاحظة جديدة بسهولة من خلال تحديد خصائص الموضوع، الجسم، واللون داخل كائن MapiNote جديد. بمجرد تكوين الملاحظة، يمكن حفظها كملف رسالة باستخدام طريقة الحفظ مع تنسيق الملف المحدد للرجوع إليه وإدارته لاحقًا.

  1. إنشاء كائن جديد MapiNote مع الموضوع، الجسم، واللون.
  2. حفظ الملاحظة في ملف msg عن طريق استدعاء طريقة Save.

إدارة قوائم التوزيع

لإنشاء وقراءة قائمة توزيع Outlook، سنستخدم فئة MapiDistributionList. ستساعدك عينات الكود التالية مع الخطوات على فهم كيفية تنفيذ هذه الوظيفة في مشروعك.

قراءة قائمة توزيع

لقراءة عنصر قائمة توزيع، ابدأ بتحميله من ملف باستخدام طريقة MapiMessage.Load. إذا كانت العنصر المحمل من نوع DistList، يمكنك بعد ذلك عرض تفاصيله مثل الاسم ومعلومات الأعضاء.

  1. تحميل قائمة توزيع من ملف.
  2. تحقق مما إذا كانت الرسالة المحملة من نوع قائمة التوزيع (DistList).
  3. تحويل الرسالة إلى كائن MapiDistributionList.
  4. عرض اسم قائمة التوزيع وأعضاءها.

إنشاء قائمة توزيع

لإنشاء قائمة توزيع جديدة، استخدم مساحة الأسماء Aspose.Email.Mapi. أضف الأعضاء إليها، مع تحديد أسمائهم وعناوين بريدهم الإلكتروني. يمكنك حفظ قائمة التوزيع بتنسيق VCF أو MSG للاستخدام المستقبلي.

  1. إنشاء قائمة توزيع جديدة باستخدام فئة MapiDistributionList.
  2. إضافة أعضاء إلى قائمة التوزيع مع عناوين بريدهم الإلكتروني.
  3. حفظ قائمة التوزيع بتنسيق VCF باستخدام طريقة Save.
  4. حفظ قائمة التوزيع بتنسيق MSG باستخدام نفس طريقة Save.

الخاتمة

في هذه المقالة، استكشافنا طرق قراءة وإنشاء عناصر Outlook مثل التقاويم، جهات الاتصال، المهام، مدخلات السجل، الملاحظات، وقوائم التوزيع برمجياً في C#. لاستخدام البرمجة، استخدمنا Aspose.Email لـ .NET، مكتبة شاملة، تجعل من السهل العمل مع المهام المتعلقة بالبريد الإلكتروني بما في ذلك التلاعب بعناصر Outlook المختلفة. من خلال الاستفادة من الفئات المقدمة من المكتبة، يمكنك إنشاء، قراءة، والتلاعب بهذه العناصر بسهولة. تناولت هذه المقالة أمثلة أساسية لكل عنصر، مما يوفر أساسًا للعمليات الأكثر تعقيدًا التي قد تحتاجها في تطبيقاتك. تساعدك عينات الكود السهلة في تقييم قدرات المكتبة وفهم كيفية تنفيذ وظائفها في مشروعك.

لا تتردد في استخدام مواردنا العامة:

  • مرجع API يقدم معلومات معمقة حول الفئات والطرق.
  • التوثيق يوفر أدلة شاملة مع أمثلة.
  • منتدى الدعم يسمح للمستخدمين بالبحث عن المساعدة ومناقشة القضايا.
  • مدونة تعرض التحديثات، الدروس، وأفضل الممارسات.

انظر أيضًا