کار با لیست های توزیع در Outlook PST

یکی از بسیاری از ویژگی های قدرتمند Outlook، توانایی ایجاد و مدیریت لیست های توزیع است. این فهرست‌ها به کاربران اجازه می‌دهند تا به راحتی ایمیل‌هایی را برای چندین گیرنده ارسال کنند و به ابزاری ارزشمند برای ساده‌سازی ارتباطات تبدیل شوند. در این مقاله، ما شما را از طریق بینش ها و ابزارهایی که برای تسلط بر مدیریت لیست های توزیع در فایل های Outlook PST نیاز دارید، راهنمایی می کنیم.

C# API برای کار با لیست های توزیع Outlook

Aspose.Email for .NET یک کتابخانه قدرتمند دات نت است که طیف وسیعی از ویژگی ها را برای کار با فایل های Outlook PST فراهم می کند. می توانید از Aspose.Email برای خواندن، نوشتن و دستکاری فایل های PST و همچنین برای کار با عناصر مختلف مانند ایمیل ها، مخاطبین، آیتم های تقویم و البته لیست های توزیع استفاده کنید. قبل از شروع کار با لیست های توزیع در فایل های Outlook PST با استفاده از C#، باید کتابخانه Aspose.Email را در پروژه خود قرار دهید. می توانید کتابخانه را از وب سایت Aspose دانلود یا از طریق NuGet نصب کنید.

Install-Package Aspose.Email

هنگامی که کتابخانه را در پروژه خود دارید، می توانید از آن برای تعامل با لیست های توزیع استفاده کنید.

خواندن لیست های توزیع از PST

برای کار با لیست های توزیع ذخیره شده در یک فایل Outlook PST، باید پوشه ای را که این لیست ها در آن ذخیره می شوند پیدا کنید و آنها را از مخاطبین معمولی متمایز کنید. در این بخش به شما نشان خواهیم داد که چگونه لیست های توزیع را از یک فایل PST بخوانید و آنها را با استفاده از C# شناسایی کنید.

using Aspose.Email.Storage.Pst;
using Aspose.Email.Mapi;

// فایل PST را بارگیری کنید
using (var pst = PersonalStorage.FromFile("your.pst"))
{
    // پوشه Contacts را دریافت کنید
    var folder = pst.GetPredefinedFolder(StandardIpmFolder.Contacts);

    if (folder != null)
    {
        foreach (var msgInfo in folder.EnumerateMessages())
        {
            // بررسی کنید که آیا پیام دارای کلاس پیام "IPM.DistList" است یا خیر
            if (msgInfo.MessageClass == "IPM.DistList")
            {
                // لیست توزیع را استخراج کنید
                var distList = (MapiDistributionList)pst.ExtractMessage(msgInfo).ToMapiMessageItem();
                
                // اکنون می توانید با لیست توزیع کار کنید
                // (به عنوان مثال، دسترسی به اعضای آن، نمایش ویژگی های آن، یا ایجاد تغییرات)
            }
        }
    }
}

در کد بالا، نحوه خواندن لیست های توزیع از یک فایل Outlook PST را نشان می دهیم. در اینجا خلاصه ای از مراحل است:

  • ما با باز کردن فایل PST با استفاده از روش PersonalStorage.FromFile شروع می کنیم.
  • ما از pst.GetPredefinedFolder(StandardIpmFolder.Contacts) برای بازیابی پوشه داخلی “Contacts” که لیست های توزیع معمولاً در آن ذخیره می شوند استفاده می کنیم.
  • ما با استفاده از folder.EnumerateMessages() پیام‌های داخل پوشه Contacts را حلقه می‌کنیم.
  • ما ویژگی MessageClass هر پیام را برای شناسایی لیست های توزیع بررسی می کنیم. لیست های توزیع دارای کلاس پیام «IPM.DistList» هستند.
  • هنگامی که یک لیست توزیع شناسایی می شود، آن را با استفاده از pst.ExtractMessage(msgInfo) استخراج می کنیم و آن را برای پردازش بیشتر به یک شی MapiDistributionList تبدیل می کنیم.

اکنون به لیست توزیع دسترسی دارید و می‌توانید با اعضای آن کار کنید، ویژگی‌های آن را نمایش دهید یا تغییرات لازم را انجام دهید.

کار با لیست های توزیع

شما می توانید عملیات مختلفی را در لیست های توزیع انجام دهید، مانند:

  • اعضای خواندنی: اعضای لیست توزیع را بازیابی کنید.
  • افزودن اعضا: اعضای جدید را به لیست توزیع اضافه کنید.
  • حذف اعضا: اعضا را از لیست توزیع حذف کنید.
  • به روز رسانی اعضا: ویژگی های اعضا را اصلاح کنید.

در اینجا یک مثال ساده از نحوه خواندن اعضای یک لیست توزیع آورده شده است:

foreach (var member in distributionList.Members)
{
    Console.WriteLine($"Name: {member.DisplayName}, Email: {member.EmailAddress}");
}

ایجاد لیست های توزیع در فایل های Outlook PST

در بسیاری از سناریوها، ممکن است لازم باشد لیست های توزیع را در فایل های Outlook PST خود ایجاد کنید. لیست های توزیع یا گروه های مخاطب به شما این امکان را می دهد که به راحتی مخاطبین را برای ارتباط ایمیل انبوه گروه بندی و مدیریت کنید. Aspose.Email فرآیند ایجاد لیست های توزیع در فایل های PST را با استفاده از C# ساده می کند. در این بخش، نحوه ایجاد لیست های توزیع در فایل PST را به شما آموزش خواهیم داد.

using Aspose.Email.Storage.Pst;
using Aspose.Email.Mapi;

// فایل PST را بارگیری کنید
using (var pst = PersonalStorage.FromFile("your.pst"))
{
    // پوشه Contacts را دریافت کنید
    var folder = pst.GetPredefinedFolder(StandardIpmFolder.Contacts);

    if (folder != null)
    {
        // ایجاد مخاطبین
        var contact1 = new MapiContact("Susanne Nielsen", "SusanneNielsen@example.com");
        var contact2 = new MapiContact("Lars Rosing", "LarsRosing@example.com");

        // مخاطبین را به پوشه مخاطبین اضافه کنید
        var idContact1 = folder.AddMapiMessageItem(contact1);
        var idContact2 = folder.AddMapiMessageItem(contact2);

        // اعضای لیست توزیع را ایجاد کنید
        var member1 = new MapiDistributionListMember(contact1.NameInfo.DisplayName, contact1.ElectronicAddresses.Email1.EmailAddress)
        {
            EntryIdType = MapiDistributionListEntryIdType.Contact,
            EntryId = Convert.FromBase64String(idContact1)
        };

        var member2 = new MapiDistributionListMember(contact2.NameInfo.DisplayName, contact2.ElectronicAddresses.Email1.EmailAddress)
        {
            EntryIdType = MapiDistributionListEntryIdType.Contact,
            EntryId = Convert.FromBase64String(idContact2)
        };

        // مجموعه ای از اعضای لیست توزیع ایجاد کنید
        var members = new MapiDistributionListMemberCollection
        {
            member1,
            member2
        };

        // لیست توزیع را ایجاد کنید
        var distributionList = new MapiDistributionList("Contact list", members)
        {
            Body = "Distribution List Body",
            Subject = "Sample Distribution List using Aspose.Email"
        };

        // لیست توزیع را به پوشه Contacts در PST اضافه کنید
        folder.AddMapiMessageItem(distributionList);
    }
}

در قطعه کد بالا، راهنمای گام به گام ایجاد لیست های توزیع در یک فایل Outlook PST را ارائه می دهیم:

  • با بارگیری فایل PST مورد نظر خود با استفاده از PersonalStorage.FromFile شروع کنید.
  • با استفاده از روش GetPredefinedFolder(StandardIpmFolder.Contacts)، پوشه “Contacts” را که می خواهید لیست توزیع خود را در آن ذخیره کنید، بازیابی کنید.
  • برای افرادی که می خواهید به لیست توزیع اضافه کنید، اشیاء MapiContact ایجاد کنید. در این مثال، ما contact1 و contact2 را ایجاد کرده‌ایم.
  • از روش AddMapiMessageItem برای افزودن اشیاء مخاطب به پوشه «Contacts» استفاده کنید. این شناسه ورودی منحصر به فرد برای هر مخاطب ایجاد می کند.
  • برای هر مخاطب، یک MapiDistributionListMember ایجاد کنید و جزئیات لازم از جمله نام نمایشی مخاطب و آدرس ایمیل را مشخص کنید.
  • اعضای لیست توزیع را در MapiDistributionListMemberCollection ذخیره کنید.
  • یک شی MapiDistributionList ایجاد کنید و نام، بدنه و موضوع را ارائه دهید. مجموعه اعضای ایجاد شده قبلی را به لیست توزیع پیوست کنید.
  • از روش AddMapiMessageItem برای افزودن لیست توزیع به پوشه Contacts در PST استفاده کنید.

اکنون با موفقیت یک لیست توزیع را در Outlook PST خود ایجاد کرده اید. این ویژگی می تواند به ویژه برای ایجاد خودکار و مدیریت گروه های مخاطب در برنامه مدیریت ایمیل شما مفید باشد.

نتیجه

کار با لیست های توزیع در فایل های Outlook PST با استفاده از C# و Aspose.Email یک فرآیند ساده است. این کتابخانه مجموعه ای قوی از ویژگی ها را برای تعامل با فایل های PST فراهم می کند که مدیریت لیست های توزیع، خواندن اعضای آنها و حتی ایجاد لیست های جدید را آسان می کند. در این پست وبلاگ، ما اصول کار با آنها را در فایل‌های Outlook PST پوشش داده‌ایم، اما کارهای بیشتری وجود دارد که می‌توانید با Aspose.Email انجام دهید. چه در حال ساختن یک ابزار مدیریت ایمیل هستید و چه نیاز به خودکارسازی برخی وظایف مربوط به ایمیل دارید، Aspose.Email یک کتابخانه ارزشمند برای توسعه دهندگان دات نت است. برای مشاوره در مورد مسائل مورد علاقه خود به صورت رایگان از مستندات ما استفاده کنید یا برای پاسخ به سوالاتی که ممکن است پیش بیاید به [تالار گفتمان] آنلاین رایگان ما مراجعه کنید. برای اطلاع از ابزارها و خدمات به روز، از وبلاگ ما دیدن کنید.

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