EWS マネージ API を使用して EWS と通信する

Exchange で EWS マネージ API を使用して EWS と通信する方法について説明します。

EWS マネージ API の ExchangeService クラスには、ユーザー資格情報の設定、EWS エンドポイントの特定、SOAP メッセージの送受信、および EWS と通信するためのバインドの構成に使用するメソッドとプロパティが含まれます。 EWS マネージ API を使用して何らかのタスクを実行するためには、ExchangeService クラスのインスタンスを作成して、それを EWS にバインドしておく必要があります。

ユーザー資格情報と EWS エンドポイントを指定して ExchangeService オブジェクトをセットアップすると、ExchangeService オブジェクトを参照するメールボックス オブジェクトは、次のメソッド タイプを使用して EWS と通信できるようになります。

• ExchangeService オブジェクト メソッド — ExchangeService オブジェクトのうち、基本 Object タイプから継承されたのではないすべてのメソッドが EWS の呼び出しを実行します。
• Exchange のメールボックス アイテム タイプ メソッドとフォルダー タイプ メソッド。

表 1. EWS と通信するメールボックス アイテム タイプ メソッドとフォルダー タイプ メソッド

EWS マネージ API を使用して EWS と通信するには

1. ExchangeService クラスをインスタンス化します。

    ExchangeService service = new ExchangeService();
   

   注:

   空のコンストラクターで ExchangeService をインスタンス化すると、既知の最新バージョンの Exchange にバインドされたインスタンスが作成されます。 あるいは、バージョンをパラメーターとして指定することにより、特定のバージョンの Exchange を対象にすることもできます。 ExchangeService service = new ExchangeService(ExchangeVersion.Exchange2007_SP1);

2. Exchange サーバーに要求を送信するユーザーの資格情報を設定します。 ドメインにログオンしているコンピューターから EWS に接続する場合は、認証されたユーザーの資格情報を使用して、ExchangeService オブジェクトの UseDefaultCredentials プロパティを true に設定します。

    // Connect by using the default credentials of the authenticated user.
    service.UseDefaultCredentials = true;
   

   既定ユーザーの資格情報を使用して接続したくない場合は、ExchangeService オブジェクトの Credentials プロパティを設定することにより、異なるユーザーの資格情報を明示的に指定します。 Exchange Online を使用する場合、または Office 365 の一部として Exchange Online を使用する場合は、ユーザー名とパスワードのみによる基本認証を使用することになります。 NTLM 認証にはドメイン名が必要です。

    // Connect by using the credentials of user1 at contoso.com.
    service.Credentials = new WebCredentials("user1@contoso.com", "password");
   

   ユーザーのドメイン名とパスワードを使用して、ユーザーの資格情報を指定することもできます。

    // Connect by using the credentials of contoso/user1.
    service.Credentials = new WebCredentials("user1", "password", "contoso");
   

   注:

   UseDefaultCredentials プロパティを true に設定した場合、Credentials プロパティの値は無視されます。

3. EWS エンドポイントの URL を設定します。 この URL は、クライアント アクセス サーバー上の exchange.asmx ファイルの場所を示します。

    // Use Autodiscover to set the URL endpoint.
    service.AutodiscoverUrl("user1@contoso.com");
   

   注:

   ExchangeService の Url プロパティをハードコーディング値に明示的に設定することもできますが、次の理由により、代わりに自動検出サービスを使用することをお勧めします。

   • 自動検出では、そのときのユーザーに最適なエンドポイント (ユーザーのメールボックス サーバーに最も近いエンドポイント) が特定されます。
   • 新しいクライアント アクセス サーバーが配置されると、EWS URL が変わる可能性があります。 このシナリオの場合、自動検出を使用するとコード変更が必要なくなります。
   • URL を明示的に設定するか、または AutodiscoverUrl を呼び出す必要がありますが、両方を行うべきではありません。

関連項目

• EWS マネージ API クライアント アプリケーションの概要
• 自動検出を使用して接続ポイントを検索する
• Exchange の Web サービス クライアントを開発する