- C# API для роботи зі списками розсилки Outlook
- Читання списків розсилки з PST
- Робота зі списками розсилки
- Створення списків розсилки у PST-файлах Outlook
Однією з багатьох потужних функцій Outlook є можливість створювати списки розсилки та керувати ними. Ці списки дозволяють користувачам легко надсилати електронні листи багатьом одержувачам, що робить їх цінним інструментом для оптимізації спілкування. У цій статті ми розповімо вам про знання та інструменти, необхідні для роботи зі списками розсилки у PST-файлах Outlook.
C# API для роботи зі списками розсилки Outlook
Aspose.Email for .NET — це потужна бібліотека .NET, яка надає широкий спектр функцій для роботи з файлами Outlook PST. Ви можете використовувати Aspose.Email для читання, запису та керування файлами PST, а також для роботи з різними елементами, такими як електронні листи, контакти, елементи календаря та, звичайно, списки розсилки. Перш ніж почати працювати зі списками розсилки у PST-файлах Outlook за допомогою 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"))
{
// Отримайте папку «Контакти».
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().
- Ми перевіряємо властивість MessageClass кожного повідомлення, щоб визначити списки розсилки. Списки розсилки мають клас повідомлень
IPM.DistList
. - Коли список розсилки визначено, ми витягуємо його за допомогою pst.ExtractMessage(msgInfo) і перетворюємо в об’єкт MapiDistributionList для подальшої обробки.
Тепер ви маєте доступ до списку розсилки та можете працювати з його членами, відображати його властивості або вносити будь-які необхідні зміни.
Робота зі списками розсилки
Ви можете виконувати різні операції зі списками розсилки, наприклад:
- Читання учасників: отримання учасників зі списку розсилки.
- Додавання учасників: додайте нових учасників до списку розсилки.
- Видалення учасників: видалення учасників зі списку розсилки.
- Оновлення учасників: змініть властивості учасників.
Ось простий приклад того, як читати членів списку розсилки:
foreach (var member in distributionList.Members)
{
Console.WriteLine($"Name: {member.DisplayName}, Email: {member.EmailAddress}");
}
Створення списків розсилки у PST-файлах Outlook
У багатьох сценаріях може знадобитися створити списки розсилки у ваших PST-файлах Outlook. Списки розсилки або групи контактів дозволяють зручно групувати контакти та керувати ними для масового спілкування електронною поштою. Aspose.Email спрощує процес створення списків розсилки у файлах PST за допомогою C#. У цьому розділі ми розповімо, як створити списки розсилки у файлі PST.
using Aspose.Email.Storage.Pst;
using Aspose.Email.Mapi;
// Завантажте файл PST
using (var pst = PersonalStorage.FromFile("your.pst"))
{
// Отримайте папку «Контакти».
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"
};
// Додайте список розсилки до папки «Контакти» в PST
folder.AddMapiMessageItem(distributionList);
}
}
У наведеному вище фрагменті коду ми надаємо покрокові інструкції зі створення списків розсилки у файлі Outlook PST:
- Почніть із завантаження цільового файлу PST за допомогою PersonalStorage.FromFile.
- За допомогою методу GetPredefinedFolder(StandardIpmFolder.Contacts) відкрийте папку
Contacts
, де ви хочете зберегти свій список розсилки. - Створіть об’єкти MapiContact для осіб, яких ви хочете додати до списку розсилки. У цьому прикладі ми створили contact1 і contact2.
- Використовуйте метод AddMapiMessageItem, щоб додати об’єкти контактів до папки «Контакти». Це генерує унікальні ідентифікатори входу для кожного контакту.
- Для кожного контакту створіть MapiDistributionListMember і вкажіть необхідні деталі, зокрема відображуване ім’я та адресу електронної пошти контакту.
- Зберігайте членів списку розсилки в MapiDistributionListMemberCollection.
- Створіть об’єкт MapiDistributionList, указавши назву, тіло та тему. Додайте раніше створену колекцію учасників до списку розсилки.
- Використовуйте метод AddMapiMessageItem, щоб додати список розсилки до папки Contacts у PST.
Тепер ви успішно створили список розсилки в Outlook PST. Ця функція може бути особливо корисною для автоматизації створення та керування групами контактів у вашій програмі керування електронною поштою.
Висновок
Робота зі списками розсилки у PST-файлах Outlook за допомогою C# і Aspose.Email є простим процесом. Бібліотека надає надійний набір функцій для взаємодії з файлами PST, що полегшує керування списками розсилки, читання їхніх учасників і навіть створення нових списків. У цій публікації блогу ми розглянули основи роботи з ними у PST-файлах Outlook, але з Aspose.Email можна зробити набагато більше. Незалежно від того, створюєте ви інструмент керування електронною поштою чи вам потрібно автоматизувати певні завдання, пов’язані з електронною поштою, Aspose.Email є цінною бібліотекою для розробників .NET. Використовуйте нашу документацію безкоштовно, щоб отримати консультації з питань, які вас цікавлять, або відвідайте наш безкоштовний онлайн-форум, щоб отримати відповіді на запитання, які можуть виникнути. Щоб бути в курсі найновіших інструментів і послуг, відвідайте наш блог.