Manage MS Contacts

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

ملفات MSG هي تنسيق مستخدم بشكل شائع لتخزين رسائل البريد الإلكتروني، والجهات، وعناصر أخرى. يمكن أن تكون عملية استخراج معلومات الاتصال من ملفات MSG الخاصة بـ Outlook برمجياً مهمة حاسمة لسيناريوهات متنوعة، مثل ترحيل البيانات أو معالجة البيانات الآلية. في هذه المقالة، سنستكشف كيفية تحميل واستخراج وحفظ معلومات الاتصال من ملفات MSG الخاصة بـ Outlook.

ابدأ مع واجهة برمجة تطبيقات C# المتقدمة

للعمل مع ملفات MSG، سنستخدم Aspose.Email for .NET. إنها مكتبة معالجة وإدارة بريد إلكتروني قوية ومتعددة الاستخدامات توفر للمطورين مجموعة شاملة من الأدوات والوظائف للعمل مع رسائل البريد الإلكتروني، والمهام، والتقويمات، وجهات الاتصال، ومهام البريد الإلكتروني المختلفة داخل تطبيقات .NET. لذا، قبل أن نبدأ، تأكد من أنك قمت بتثبيت Aspose.Email وإشارته في مشروعك. إذا لم تفعل ذلك بعد، يمكنك تحميل ملف DLL الخاص به أو تثبيته من NuGet.

تحميل جهة الاتصال من ملفات MSG

لاستخراج معلومات الاتصال من ملف MSG، نحتاج إلى تحميل الملف إلى كائن MapiMessage باستخدام طريقة MapiMessage.Load الخاصة بـ Aspose.Email. يمكنك تحميل جهة الاتصال إلى MapiMessage، والتعامل معها مثل رسالة MAPI عادية: قراءة الخصائص، التعديل، الحفظ، الإضافة إلى التخزين، الإرسال. ستظهر لك عينة الكود التالية كيفية تحميل ومعالجة جهات الاتصال الخاصة بـ Outlook:

  1. تحميل عنصر جهة اتصال موجود في ملف MSG باستخدام طريقة MapiMessage.Load. تقرأ هذه الطريقة محتويات ملف MSG المحدد وتقوم بإنشاء كائن MapiMessage يمثل رسالة البريد الإلكتروني.
  2. تعيين محتوى الجسم HTML باستخدام طريقة SetBodyContent لاستبدال المحتوى.
  3. تحديد معلمة BodyContentType.Html التي تشير إلى أن المحتوى المقدم بتنسيق HTML. يضمن ذلك أن يتم تفسير المحتوى بشكل صحيح على أنه HTML عند مشاهدته بواسطة عملاء البريد الإلكتروني.
  4. حفظ كائن MapiMessage المعدل مرة أخرى إلى ملف MSG باستخدام طريقة Save.
var msg = MapiMessage.Load("Lynna M. Dyer.msg");
msg.SetBodyContent("<!DOCTYPE html><html><body><h1>Lynna M. Dyer</h1></body></html>", BodyContentType.Html);
msg.Save("Lynna M. Dyer.msg");

استخراج تفاصيل جهة الاتصال

بمجرد تحميل ملف MSG، يمكننا استخراج تفاصيل جهة الاتصال باستخدام فئة MapiContact. توفر MapiContact خصائص ملائمة للوصول إلى حقول الاتصال المحددة. توضح عينة الكود المقدمة كيفية استخراج وعرض معلومات الاتصال من بريد MSG الإلكتروني.

  1. ابدأ بالتحقق مما إذا كان MSG هو عنصر جهة اتصال. استخدم خاصية SupportedType التي تشير إلى نوع عنصر Outlook.
  2. تحويل كائن msg إلى كائن MapiContact. يسمح هذا التحويل بالوصول إلى الخصائص والأساليب المتخصصة الخاصة بعناصر الاتصال.
  3. استرجاع وعرض معلومات الاتصال. في هذا المثال، نقوم بالوصول إلى خصائص DisplayName، Email، CompanyName، وTitle لكائن MapiContact، والتي تمثل اسم جهة الاتصال، عنوان البريد الإلكتروني، اسم الشركة، ولقب العمل على التوالي. يمكنك الوصول إلى خصائص أخرى لكائن MapiContact حسب متطلباتك.
if (msg.SupportedType == MapiItemType.Contact)
{
    var contact = (MapiContact)msg.ToMapiMessageItem();

    Console.WriteLine(contact.NameInfo.DisplayName);
    Console.WriteLine(contact.ElectronicAddresses.Email1);
    Console.WriteLine(contact.ProfessionalInfo.CompanyName);
    Console.WriteLine(contact.ProfessionalInfo.Title);
}

حفظ صورة جهة الاتصال

إذا كانت ملف MSG يحتوي على صورة للجهة الاتصال، يمكننا حفظها في ملف باستخدام الكود التالي:

  1. تحقق مما إذا كانت جهة الاتصال تحتوي على صورة. يتم ذلك من خلال تقييم ما إذا كانت خاصية contact.Photo ليست null.
  2. إذا كانت صورة موجودة، يتقدم الكود لحفظها كملف.
if (contact.Photo != null)
{
    System.IO.File.WriteAllBytes($"{contact.NameInfo.DisplayName}.{MapiContactPhotoImageFormat.Jpeg.ToString()}", contact.Photo.Data);
}

حفظ جهة الاتصال إلى VCF

بالإضافة إلى ذلك، من الضروري غالباً تحويل جهة الاتصال من MSG إلى تنسيق أكثر شمولاً مثل VCARD. VCard (ملف الاتصال الافتراضي) هو تنسيق ملف قياسي يُستخدم لتخزين معلومات الاتصال. توضح عينة الكود التالية كيفية حفظ عنصر جهة اتصال ممثل بواسطة كائن الاتصال كملف VCard:

يستخدم الكود طريقة Save الخاصة بكائن الاتصال لبدء عملية حفظ جهة الاتصال كـ VCard.

contact.Save("Lynna M. Dyer.vcf", ContactSaveFormat.VCard);

تحميل جهة الاتصال من VCF

يمكنك أيضاً تحميل ملف VCARD موجود إلى كائن MapiContact. توضح عينة الكود التالية كيفية تحميل معلومات الاتصال من VCard وإنشاء كائن MapiContact:

  1. يبدأ الكود باستخدام طريقة MapiContact.FromVCard لتحميل معلومات الاتصال من VCard.
  2. يحتوي المتغير contact على كائن MapiContact الجديد الذي تم إنشاؤه، والذي يمكن استخدامه للوصول إلى تفاصيل جهة الاتصال والتلاعب بها برمجياً.
var contact = MapiContact.FromVCard("Lynna M. Dyer.vcf");

الخاتمة

في هذه المقالة، استكشفنا كيفية استخراج معلومات الاتصال من ملفات MSG الخاصة بـ Outlook برمجياً باستخدام Aspose.Email. قمنا بجولة في عملية تحميل ملف MSG، واستخراج تفاصيل الاتصال باستخدام فئة MapiContact، وحفظ جهة الاتصال في تنسيقات مختلفة. تبسط Aspose.Email عملية العمل مع ملفات MSG وتوفر مجموعة واسعة من الوظائف للتعامل مع بيانات البريد الإلكتروني.

تذكر تعديل مسارات الملفات وتكييف الكود ليتناسب مع متطلباتك الخاصة. ستساعدك وثائق Aspose.Email الشاملة والمنتديات المجتمعية المفيدة في الاستفادة من قدراته لاستخراج معلومات الاتصال بفعالية.

انظر أيضاً