通过

ExchangeService.AutodiscoverUrl 方法

  • 参考

定义

命名空间:
Microsoft.Exchange.WebServices.Data
程序集:
Microsoft.Exchange.WebServices.dll

重载

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

要使用的电子邮件地址。

例外

AutodiscoverLocalException

本地故障（例如重定向受阻或多个大于最大值的重定向）会导致自动发现停止。

AutodiscoverRemoteException

自动发现服务器返回错误。

ServiceValidationException

参数中 emailAddress 传递了一个空值。

示例

以下示例演示如何使用 AutodiscoverUrl(String) 方法获取用户的 EWS URL。

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 (字符串 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 的回调。

例外

AutodiscoverLocalException

本地故障（例如重定向受阻或多个大于最大值的重定向）会导致自动发现停止。

AutodiscoverRemoteException

自动发现服务器返回错误。

ServiceValidationException

参数中 emailAddress 传递了一个空值。

示例

以下示例演示如何使用 AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) 方法获取用户的 EWS URL。

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 重定向状态时，自动发现跟踪重定向。

适用于