ExchangeService.AutodiscoverUrl Méthode

Définition

Espace de noms:

Microsoft.Exchange.WebServices.Data

Assembly:

Microsoft.Exchange.WebServices.dll

Surcharges

AutodiscoverUrl(String)	Initialise la Url propriété sur le point de terminaison des services Web Exchange (EWS) pour une adresse e-mail spécifiée en appelant le service de découverte automatique.
AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)	Initialise la Url propriété sur le point de terminaison des services Web Exchange (EWS) pour une adresse e-mail spécifiée en appelant le service de découverte automatique.

AutodiscoverUrl(String)

Initialise la Url propriété sur le point de terminaison des services Web Exchange (EWS) pour une adresse e-mail spécifiée en appelant le service de découverte automatique.

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

public void AutodiscoverUrl (string emailAddress);

Public Sub AutodiscoverUrl (emailAddress As String)

Paramètres

emailAddress

String

Adresse e-mail à utiliser.

Exceptions

AutodiscoverLocalException

Une défaillance locale, telle qu’une redirection bloquée ou un nombre de redirections supérieur à la valeur maximale, a provoqué l’arrêt de la découverte automatique.

AutodiscoverRemoteException

Le serveur de découverte automatique a retourné une erreur.

ServiceValidationException

Une valeur vide a été passée dans le emailAddress paramètre .

Exemples

L’exemple suivant montre comment obtenir l’URL EWS de l’utilisateur à l’aide de la AutodiscoverUrl(String) méthode .

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

Remarques

Si un serveur de découverte automatique retourne un code d’état HTTP de redirection, cette méthode génère un AutodiscoverLocalException avec la propriété Message définie sur une chaîne telle que « La découverte automatique a bloqué une redirection potentiellement non sécurisée vers https://autodiscover.contoso.com/autodiscover/autodiscover.xml. Pour autoriser la découverte automatique à suivre la redirection, utilisez la surcharge AutodiscoverUrl(string, AutodiscoverRedirectionUrlValidationCallback). Cette exception est générée pour toutes les réponses de redirection, quelle que soit la validité de l’URL retournée dans la réponse de redirection.

Pour activer la redirection, utilisez la surcharge à la AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) place.

AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)

Initialise la Url propriété sur le point de terminaison des services Web Exchange (EWS) pour une adresse e-mail spécifiée en appelant le service de découverte automatique.

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)

Paramètres

emailAddress

String

Adresse e-mail à utiliser.

validateRedirectionUrlCallback

AutodiscoverRedirectionUrlValidationCallback

Rappel utilisé pour valider l’URL de redirection.

Exceptions

AutodiscoverLocalException

Une défaillance locale, telle qu’une redirection bloquée ou un nombre de redirections supérieur à la valeur maximale, a provoqué l’arrêt de la découverte automatique.

AutodiscoverRemoteException

Le serveur de découverte automatique a retourné une erreur.

ServiceValidationException

Une valeur vide a été passée dans le emailAddress paramètre .

Exemples

L’exemple suivant montre comment obtenir l’URL EWS de l’utilisateur à l’aide de la AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) méthode .

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

Remarques

Cette méthode permet à la découverte automatique de suivre les redirections lorsqu’un serveur de découverte automatique répond avec un état de redirection 302.