Manage MS Contacts

مدیریت کارآمد مخاطب برای حرفه‌ای‌ها و کسب‌وکارها حیاتی است. این امر تضمین می‌کند که شما می‌توانید به راحتی افراد مناسب را زمانی که به آنها نیاز دارید پیدا کنید و با آنها ارتباط برقرار کنید. چه در حال برنامه‌ریزی جلسات، ارسال ایمیل یا به اشتراک‌گذاری اسناد باشید، داشتن مخاطبین منظم و به‌روز می‌تواند به طرز قابل توجهی بهره‌وری شما را بهبود بخشد.

فایل‌های MSG فرمت رایجی برای ذخیره پیام‌های ایمیل، مخاطبین و سایر اقلام است. استخراج اطلاعات تماس از فایل‌های MSG Outlook به صورت برنامه‌نویسی می‌تواند یک کار حیاتی برای سناریوهای مختلف باشد، مانند مهاجرت داده‌ها یا پردازش خودکار داده‌ها. در این مقاله، ما به بررسی نحوه بارگذاری، استخراج و ذخیره اطلاعات تماس از فایل‌های MSG Outlook خواهیم پرداخت.

شروع با API پیشرفته 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 ویرایش شده را با استفاده از متد Save دوباره به یک فایل MSG ذخیره کنید.
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 نال نیست انجام می‌شود.
  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 و انجمن‌های مفید آن به شما در بهره‌برداری موثر از قابلیت‌های آن برای استخراج اطلاعات تماس کمک خواهند کرد.

همچنین ببینید