- C# API pro práci s distribučními seznamy aplikace Outlook
- Čtení distribučních seznamů z PST
- Práce s distribučními seznamy
- Vytváření distribučních seznamů v souborech PST aplikace Outlook
Jednou z mnoha výkonných funkcí, které Outlook nabízí, je možnost vytvářet a spravovat distribuční seznamy. Tyto seznamy umožňují uživatelům snadno odesílat e-maily více příjemcům, což z nich činí cenný nástroj pro zefektivnění komunikace. V tomto článku vás provedeme přehledy a nástroji, které potřebujete ke zvládnutí práce s distribučními seznamy v souborech PST aplikace Outlook.
C# API pro práci s distribučními seznamy aplikace Outlook
Aspose.Email for .NET je výkonná knihovna .NET, která poskytuje širokou škálu funkcí pro práci se soubory Outlook PST. Aspose.Email můžete použít ke čtení, zápisu a manipulaci se soubory PST a také k práci s různými prvky, jako jsou e-maily, kontakty, položky kalendáře a samozřejmě distribuční seznamy. Než budete moci začít pracovat s distribučními seznamy v souborech PST aplikace Outlook pomocí jazyka C#, budete muset do projektu zahrnout knihovnu Aspose.Email. Knihovnu si můžete stáhnout z webu Aspose nebo ji nainstalovat pomocí NuGet.
Install-Package Aspose.Email
Jakmile budete mít knihovnu ve svém projektu, můžete ji začít používat k interakci s distribučními seznamy.
Čtení distribučních seznamů z PST
Chcete-li pracovat s distribučními seznamy uloženými v souboru PST aplikace Outlook, budete muset najít složku, kde jsou tyto seznamy uloženy, a odlišit je od běžných kontaktů. V této části vám ukážeme, jak číst distribuční seznamy ze souboru PST a identifikovat je pomocí C#.
using Aspose.Email.Storage.Pst;
using Aspose.Email.Mapi;
// Načtěte soubor PST
using (var pst = PersonalStorage.FromFile("your.pst"))
{
// Získejte složku Kontakty
var folder = pst.GetPredefinedFolder(StandardIpmFolder.Contacts);
if (folder != null)
{
foreach (var msgInfo in folder.EnumerateMessages())
{
// Zkontrolujte, zda má zpráva třídu zprávy "IPM.DistList".
if (msgInfo.MessageClass == "IPM.DistList")
{
// Rozbalte distribuční seznam
var distList = (MapiDistributionList)pst.ExtractMessage(msgInfo).ToMapiMessageItem();
// Nyní můžete pracovat s distribučním seznamem
// (např. přistupovat k jeho členům, zobrazovat jeho vlastnosti nebo provádět úpravy)
}
}
}
}
Ve výše uvedeném kódu ukazujeme, jak číst distribuční seznamy ze souboru PST aplikace Outlook. Zde je rozpis kroků:
- Začneme otevřením souboru PST pomocí metody PersonalStorage.FromFile.
- Používáme pst.GetPredefinedFolder(StandardIpmFolder.Contacts) k načtení vestavěné složky “Kontakty”, kde jsou obvykle uloženy distribuční seznamy.
- Procházíme zprávy ve složce Kontakty pomocí folder.EnumerateMessages().
- Zkontrolujeme vlastnost MessageClass každé zprávy, abychom identifikovali distribuční seznamy. Distribuční seznamy mají třídu zpráv
IPM.DistList
. - Když je identifikován distribuční seznam, extrahujeme jej pomocí pst.ExtractMessage(msgInfo) a převedeme jej na objekt MapiDistributionList pro další zpracování.
Nyní máte přístup k distribučnímu seznamu a můžete pracovat s jeho členy, zobrazovat jeho vlastnosti nebo provádět potřebné úpravy.
Práce s distribučními seznamy
S distribučními seznamy můžete provádět různé operace, například:
- Čtení členů: Načte členy distribučního seznamu.
- Přidání členů: Přidejte nové členy do distribučního seznamu.
- Odebrání členů: Odeberte členy z distribučního seznamu.
- Aktualizace členů: Upravte vlastnosti členů.
Zde je jednoduchý příklad, jak číst členy distribučního seznamu:
foreach (var member in distributionList.Members)
{
Console.WriteLine($"Name: {member.DisplayName}, Email: {member.EmailAddress}");
}
Vytváření distribučních seznamů v souborech PST aplikace Outlook
V mnoha scénářích může být nutné vytvořit distribuční seznamy v souborech PST aplikace Outlook. Distribuční seznamy neboli skupiny kontaktů vám umožňují pohodlně seskupovat a spravovat kontakty pro hromadnou e-mailovou komunikaci. Aspose.Email zjednodušuje proces vytváření distribučních seznamů v souborech PST pomocí C#. V této části vás provedeme vytvořením distribučních seznamů v souboru PST.
using Aspose.Email.Storage.Pst;
using Aspose.Email.Mapi;
// Načtěte soubor PST
using (var pst = PersonalStorage.FromFile("your.pst"))
{
// Získejte složku Kontakty
var folder = pst.GetPredefinedFolder(StandardIpmFolder.Contacts);
if (folder != null)
{
// Vytvořte kontakty
var contact1 = new MapiContact("Susanne Nielsen", "SusanneNielsen@example.com");
var contact2 = new MapiContact("Lars Rosing", "LarsRosing@example.com");
// Přidejte kontakty do složky Kontakty
var idContact1 = folder.AddMapiMessageItem(contact1);
var idContact2 = folder.AddMapiMessageItem(contact2);
// Vytvořte členy distribučního seznamu
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)
};
// Vytvořte kolekci členů distribučního seznamu
var members = new MapiDistributionListMemberCollection
{
member1,
member2
};
// Vytvořte distribuční seznam
var distributionList = new MapiDistributionList("Contact list", members)
{
Body = "Distribution List Body",
Subject = "Sample Distribution List using Aspose.Email"
};
// Přidejte distribuční seznam do složky Kontakty v PST
folder.AddMapiMessageItem(distributionList);
}
}
Ve výše uvedeném fragmentu kódu poskytujeme podrobného průvodce vytvářením distribučních seznamů v souboru PST aplikace Outlook:
- Začněte načtením cílového souboru PST pomocí PersonalStorage.FromFile.
- Pomocí metody GetPredefinedFolder(StandardIpmFolder.Contacts) načtěte složku
Contacts
, kam chcete uložit svůj distribuční seznam. - Vytvořte objekty MapiContact pro osoby, které chcete přidat do distribučního seznamu. V tomto příkladu jsme vytvořili kontakt1 a kontakt2.
- Pomocí metody AddMapiMessageItem přidejte objekty kontaktu do složky
Contacts
. To generuje jedinečné ID položky pro každý kontakt. - Pro každý kontakt vytvořte MapiDistributionListMember a zadejte potřebné podrobnosti, včetně zobrazovaného jména kontaktu a e-mailové adresy.
- Uložte členy distribučního seznamu do MapiDistributionListMemberCollection.
- Vytvořte objekt MapiDistributionList s názvem, tělem a předmětem. Připojte dříve vytvořenou kolekci členů k distribučnímu seznamu.
- Pomocí metody AddMapiMessageItem přidejte distribuční seznam do složky Kontakty v PST.
Nyní jste úspěšně vytvořili distribuční seznam v rámci vašeho Outlook PST. Tato funkce může být zvláště užitečná pro automatizaci vytváření a správy skupin kontaktů ve vaší aplikaci pro správu e-mailů.
Závěr
Práce s distribučními seznamy v souborech Outlook PST pomocí C# a Aspose.Email je jednoduchý proces. Knihovna poskytuje robustní sadu funkcí pro interakci se soubory PST, což usnadňuje správu distribučních seznamů, čtení jejich členů a dokonce vytváření nových seznamů. V tomto příspěvku na blogu jsme probrali základy práce s nimi v souborech PST aplikace Outlook, ale s Aspose.Email můžete dělat mnohem víc. Ať už vytváříte nástroj pro správu e-mailů nebo potřebujete automatizovat určité úlohy související s e-mailem, Aspose.Email je cenná knihovna pro vývojáře .NET. Využijte naši dokumentaci zdarma ke konzultaci o otázkách, které vás zajímají, nebo se obraťte na naše bezplatné online fórum, kde najdete odpovědi na otázky, které mohou vyvstat. Chcete-li zůstat informováni o aktuálních nástrojích a službách, navštivte náš blog.