ExchangeService.AutodiscoverUrl Метод

Определение

Пространство имен:

Microsoft.Exchange.WebServices.Data

Сборка:

Microsoft.Exchange.WebServices.dll

Перегрузки

AutodiscoverUrl(String)	Инициализирует Url свойство в конечной точке веб-служб Exchange (EWS) для указанного адреса электронной почты, вызывая службу автообнаружения.
AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)	Инициализирует Url свойство в конечной точке веб-служб Exchange (EWS) для указанного адреса электронной почты, вызывая службу автообнаружения.

AutodiscoverUrl(String)

Инициализирует Url свойство в конечной точке веб-служб Exchange (EWS) для указанного адреса электронной почты, вызывая службу автообнаружения.

public:
 void AutodiscoverUrl(System::String ^ emailAddress);

public void AutodiscoverUrl (string emailAddress);

Public Sub AutodiscoverUrl (emailAddress As String)

Параметры

emailAddress

String

Используемый адрес электронной почты.

Исключения

AutodiscoverLocalException

Локальный сбой, например заблокированное перенаправление или количество перенаправлений, превышающее максимальное, привело к остановке автообнаружения.

AutodiscoverRemoteException

Сервер автообнаружения вернул ошибку.

ServiceValidationException

В параметре передано пустое emailAddress значение.

Примеры

В следующем примере показано, как получить URL-адрес EWS пользователя с помощью 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 перенаправления, этот метод создаст AutodiscoverLocalException объект со свойством Message со строкой, например "Автообнаружение заблокировало потенциально небезопасное перенаправление на. https://autodiscover.contoso.com/autodiscover/autodiscover.xml. Чтобы разрешить автообнаружению следовать перенаправлению, используйте перегрузку AutodiscoverUrl(string, AutodiscoverRedirectionUrlValidationCallback). Это исключение создается для всех ответов перенаправления, независимо от допустимости URL-адреса, возвращаемого в ответе перенаправления.

Чтобы включить перенаправление, используйте перегрузку AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) .

AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)

Инициализирует Url свойство в конечной точке веб-служб Exchange (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-адреса перенаправления.

Исключения

AutodiscoverLocalException

Локальный сбой, например заблокированное перенаправление или количество перенаправлений, превышающее максимальное, привело к остановке автообнаружения.

AutodiscoverRemoteException

Сервер автообнаружения вернул ошибку.

ServiceValidationException

В параметре передано пустое emailAddress значение.

Примеры

В следующем примере показано, как получить URL-адрес EWS пользователя с помощью 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.