Outlook PST での配布リストの操作

Outlook が提供する多くの強力な機能の 1 つは、配布リストを作成および管理する機能です。これらのリストを使用すると、ユーザーは複数の受信者に電子メールを簡単に送信できるため、コミュニケーションを合理化するための貴重なツールになります。 この記事では、Outlook PST ファイルの配布リストの処理をマスターするために必要な洞察とツールについて説明します。

Outlook 配布リストを操作するための C# API

Aspose.Email for .NET は、Outlook PST ファイルを操作するための幅広い機能を提供する強力な .NET ライブラリです。 Aspose.Email を使用すると、PST ファイルの読み取り、書き込み、操作ができるほか、電子メール、連絡先、予定表アイテム、そしてもちろん配布リストなどのさまざまな要素を操作できます。 C# を使用して Outlook PST ファイルの配布リストの操作を開始する前に、プロジェクトに Aspose.Email ライブラリを含める必要があります。このライブラリは、Aspose Web サイトから ダウンロード するか、NuGet 経由でインストールできます。

Install-Package Aspose.Email

プロジェクトにライブラリを追加したら、それを使用して配布リストを操作できるようになります。

PST からの配布リストの読み取り

Outlook 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)
    {
        foreach (var msgInfo in folder.EnumerateMessages())
        {
            // メッセージに「IPM.DistList」メッセージ クラスがあるかどうかを確認します。
            if (msgInfo.MessageClass == "IPM.DistList")
            {
                // 配布リストを抽出する
                var distList = (MapiDistributionList)pst.ExtractMessage(msgInfo).ToMapiMessageItem();
                
                // これで、配布リストを操作できるようになりました。
                // (例: メンバーへのアクセス、プロパティの表示、または変更)
            }
        }
    }
}

上記のコードでは、Outlook PST ファイルから配布リストを読み取る方法を示します。手順の内訳は次のとおりです。

これで、配布リストにアクセスできるようになり、そのメンバーを操作したり、プロパティを表示したり、必要な変更を加えたりできるようになりました。

配布リストの操作

配布リストに対して次のようなさまざまな操作を実行できます。

  • メンバーの読み取り: 配布リストのメンバーを取得します。
  • メンバーの追加: 新しいメンバーを配布リストに追加します。
  • メンバーの削除: 配布リストからメンバーを削除します。
  • メンバーの更新: メンバーのプロパティを変更します。

配布リストのメンバーを読み取る方法の簡単な例を次に示します。

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

Outlook PST ファイルでの配布リストの作成

多くのシナリオでは、Outlook PST ファイル内に配布リストを作成することが必要になる場合があります。配布リストまたは連絡先グループを使用すると、大量の電子メール通信のために連絡先を簡単にグループ化し、管理できます。 Aspose.Email は、C# を使用して PST ファイルに配布リストを作成するプロセスを簡素化します。このセクションでは、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 ファイルで配布リストを作成するためのステップバイステップ ガイドを提供します。

  • PersonalStorage.FromFile を使用してターゲット PST ファイルをロードすることから始めます。
  • GetPredefineFolder(StandardIpmFolder.Contacts) メソッドを使用して、配布リストを保存する Contacts フォルダーを取得します。
  • 配布リストに追加するユーザーの MapiContact オブジェクトを作成します。この例では、contact1 と contact2 を作成しました。
  • AddMapiMessageItem メソッドを使用して、連絡先オブジェクトを「Contacts」フォルダーに追加します。これにより、連絡先ごとに一意のエントリ ID が生成されます。
  • 連絡先ごとに MapiDistributionListMember を作成し、連絡先の表示名や電子メール アドレスなどの必要な詳細を指定します。
  • 配布リストのメンバーを MapiDistributionListMemberCollection に保存します。
  • MapiDistributionList オブジェクトを作成し、名前、本文、件名を指定します。以前に作成したメンバー コレクションを配布リストに添付します。
  • AddMapiMessageItem メソッドを使用して、配布リストを PST の連絡先フォルダーに追加します。

これで、Outlook PST 内に配布リストが正常に作成されました。この機能は、電子メール管理アプリケーション内で連絡先グループの作成と管理を自動化する場合に特に役立ちます。

結論

C# と Aspose.Email を使用して Outlook PST ファイルの配布リストを操作するのは簡単なプロセスです。このライブラリは、PST ファイルを操作するための強力な機能セットを提供し、配布リストの管理、そのメンバーの読み取り、さらには新しいリストの作成を容易にします。このブログ投稿では、Outlook PST ファイルでの操作の基本について説明しましたが、Aspose.Email を使用してできることはさらにたくさんあります。電子メール管理ツールを構築している場合でも、特定の電子メール関連タスクを自動化する必要がある場合でも、Aspose.Email は .NET 開発者にとって貴重なライブラリです。 関心のある問題について相談するには、無料で ドキュメント をご利用ください。または、発生する可能性のある質問への回答については、無料のオンライン フォーラム にアクセスしてください。最新のツールとサービスに関する情報を入手するには、ブログ をご覧ください。

関連項目