ExchangeService.AutodiscoverUrl Método

Definição

Namespace:

Microsoft.Exchange.WebServices.Data

Assembly:

Microsoft.Exchange.WebServices.dll

Sobrecargas

AutodiscoverUrl(String)	Inicializa a Url propriedade para o ponto de extremidade do Exchange Web Services (EWS) para um endereço de email especificado chamando o serviço autodiscover.
AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)	Inicializa a Url propriedade para o ponto de extremidade do Exchange Web Services (EWS) para um endereço de email especificado chamando o serviço autodiscover.

AutodiscoverUrl(String)

Inicializa a Url propriedade para o ponto de extremidade do Exchange Web Services (EWS) para um endereço de email especificado chamando o serviço autodiscover.

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

public void AutodiscoverUrl (string emailAddress);

Public Sub AutodiscoverUrl (emailAddress As String)

Parâmetros

emailAddress

String

O endereço de email a ser usado.

Exceções

AutodiscoverLocalException

Uma falha local, como um redirecionamento bloqueado ou um número de redirecionamentos maior que o máximo, fez com que o Autodiscover parasse.

AutodiscoverRemoteException

O servidor Autodiscover retornou um erro.

ServiceValidationException

Um valor vazio foi passado no emailAddress parâmetro.

Exemplos

O exemplo a seguir mostra como obter a URL EWS do usuário usando o AutodiscoverUrl(String) método.

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);
}

Comentários

Se um servidor Autodiscover retornar um código de status HTTP de redirecionamento, esse método gerará um AutodiscoverLocalException com a propriedade Message definida como uma cadeia de caracteres como "Autodiscover bloqueou um redirecionamento potencialmente inseguro para https://autodiscover.contoso.com/autodiscover/autodiscover.xml. Para permitir que Autodiscover siga o redirecionamento, use a sobrecarga AutodiscoverUrl(string, AutodiscoverRedirectionUrlValidationCallback)". Essa exceção é gerada para todas as respostas de redirecionamento, independentemente da validade da URL retornada na resposta de redirecionamento.

Para habilitar o redirecionamento, use a AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) sobrecarga.

AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)

Inicializa a Url propriedade para o ponto de extremidade do Exchange Web Services (EWS) para um endereço de email especificado chamando o serviço autodiscover.

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)

Parâmetros

emailAddress

String

O endereço de email a ser usado.

validateRedirectionUrlCallback

AutodiscoverRedirectionUrlValidationCallback

O retorno de chamada usado para validar a URL de redirecionamento.

Exceções

AutodiscoverLocalException

Uma falha local, como um redirecionamento bloqueado ou um número de redirecionamentos maior que o máximo, fez com que o Autodiscover parasse.

AutodiscoverRemoteException

O servidor Autodiscover retornou um erro.

ServiceValidationException

Um valor vazio foi passado no emailAddress parâmetro.

Exemplos

O exemplo a seguir mostra como obter a URL EWS do usuário usando o AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) método.

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);
}

Comentários

Esse método permite que Autodiscover siga redirecionamentos quando um servidor de descoberta automática responde com um status de redirecionamento 302.