ExchangeService.AutodiscoverUrl メソッド

定義

オーバーロード

AutodiscoverUrl(String)

自動検出サービスを Url 呼び出して、指定した電子メール アドレスの Exchange Web Services (EWS) エンドポイントにプロパティを初期化します。

AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)

自動検出サービスを Url 呼び出して、指定した電子メール アドレスの Exchange Web Services (EWS) エンドポイントにプロパティを初期化します。

AutodiscoverUrl(String)

自動検出サービスを Url 呼び出して、指定した電子メール アドレスの Exchange Web Services (EWS) エンドポイントにプロパティを初期化します。

public:
 void AutodiscoverUrl(System::String ^ emailAddress);
public void AutodiscoverUrl (string emailAddress);
Public Sub AutodiscoverUrl (emailAddress As String)

パラメーター

emailAddress
String

使用するメール アドレス。

例外

ブロックされたリダイレクトや最大数を超えるリダイレクトなど、ローカルエラーによって自動検出が停止しました。

自動検出サーバーからエラーが返されました。

パラメーターに空の値が emailAddress 渡されました。

次の例は、 メソッドを使用してユーザーの EWS URL を取得する方法を AutodiscoverUrl(String) 示しています。

using System.Net;
using System.Security;
using Microsoft.Exchange.WebServices.Data;

static void GetUsersEwsUrl(string userEmailAddress, SecureString userPassword)
{
    ExchangeService service = new ExchangeService();

    // Set specific credentials.
    service.Credentials = new NetworkCredential(userEmailAddress, userPassword);

    // Look up the user's EWS endpoint by using Autodiscover.
    service.AutodiscoverUrl(userEmailAddress);

    Console.WriteLine("EWS Endpoint: {0}", service.Url);
}

注釈

自動検出サーバーがリダイレクト HTTP 状態コードを返す場合、このメソッドは Message プロパティを文字列に設定して を生成AutodiscoverLocalExceptionします。"自動検出によって、安全でない可能性のあるリダイレクトが ブロックされました。https://autodiscover.contoso.com/autodiscover/autodiscover.xml. 自動検出がリダイレクトに従えるようにするには、AutodiscoverUrl(string, AutodiscoverRedirectionUrlValidationCallback) オーバーロードを使用します。 この例外は、リダイレクト応答で返される URL の有効性に関係なく、すべてのリダイレクト応答に対して生成されます。

リダイレクトを有効にするには、代わりに オーバーロードを AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) 使用します。

適用対象

AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)

自動検出サービスを Url 呼び出して、指定した電子メール アドレスの Exchange Web Services (EWS) エンドポイントにプロパティを初期化します。

public:
 void AutodiscoverUrl(System::String ^ emailAddress, Microsoft::Exchange::WebServices::Autodiscover::AutodiscoverRedirectionUrlValidationCallback ^ validateRedirectionUrlCallback);
public void AutodiscoverUrl (string emailAddress, Microsoft.Exchange.WebServices.Autodiscover.AutodiscoverRedirectionUrlValidationCallback validateRedirectionUrlCallback);
Public Sub AutodiscoverUrl (emailAddress As String, validateRedirectionUrlCallback As AutodiscoverRedirectionUrlValidationCallback)

パラメーター

emailAddress
String

使用するメール アドレス。

validateRedirectionUrlCallback
AutodiscoverRedirectionUrlValidationCallback

リダイレクト URL の検証に使用されるコールバック。

例外

ブロックされたリダイレクトや最大数を超えるリダイレクトなど、ローカルエラーによって自動検出が停止しました。

自動検出サーバーからエラーが返されました。

パラメーターに空の値が emailAddress 渡されました。

次の例は、 メソッドを使用してユーザーの EWS URL を取得する方法を AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) 示しています。

using System.Net;
using System.Security;
using Microsoft.Exchange.WebServices.Data;

static bool RedirectionCallback(string url)
{
    // Return true if the URL is an HTTPS URL.
    return url.ToLower().StartsWith("https://");
}

static void GetUsersEwsUrl(string userEmailAddress, SecureString userPassword)
{
    ExchangeService service = new ExchangeService();

    // Set specific credentials.
    service.Credentials = new NetworkCredential(userEmailAddress, userPassword);

    // Look up the user's EWS endpoint by using Autodiscover.
    service.AutodiscoverUrl(userEmailAddress, RedirectionCallback);

    Console.WriteLine("EWS Endpoint: {0}", service.Url);
}

注釈

このメソッドを使用すると、自動検出サーバーが 302 リダイレクト状態で応答したときに、自動検出がリダイレクトに従うことができます。

適用対象