ExchangeService.AutodiscoverUrl Methode

Definition

Überlädt

AutodiscoverUrl(String)

Initialisiert die Url -Eigenschaft für den EWS-Endpunkt (Exchange Web Services) für eine angegebene E-Mail-Adresse, indem der AutoErmittlungsdienst aufgerufen wird.

AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)

Initialisiert die Url -Eigenschaft für den EWS-Endpunkt (Exchange Web Services) für eine angegebene E-Mail-Adresse, indem der AutoErmittlungsdienst aufgerufen wird.

AutodiscoverUrl(String)

Initialisiert die Url -Eigenschaft für den EWS-Endpunkt (Exchange Web Services) für eine angegebene E-Mail-Adresse, indem der AutoErmittlungsdienst aufgerufen wird.

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

Parameter

emailAddress
String

Die zu verwendende E-Mail-Adresse.

Ausnahmen

Ein lokaler Fehler, z. B. eine blockierte Umleitung oder eine Anzahl von Umleitungen, die größer als der Höchstwert sind, führte dazu, dass die AutoErmittlung beendet wurde.

Der AutoErmittlungsserver hat einen Fehler zurückgegeben.

Im Parameter wurde ein leerer emailAddress Wert übergeben.

Beispiele

Das folgende Beispiel zeigt, wie Sie die EWS-URL des Benutzers mithilfe der AutodiscoverUrl(String) -Methode abrufen.

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

Hinweise

Wenn ein AutoErmittlungsserver einen UMleitungs-HTTP-Statuscode zurückgibt, generiert diese Methode einen AutodiscoverLocalException , wobei die Message-Eigenschaft auf eine Zeichenfolge wie "AutoErmittlung blockiert eine potenziell unsichere Umleitung an https://autodiscover.contoso.com/autodiscover/autodiscover.xml. Verwenden Sie die Überladung AutodiscoverUrl(string, AutodiscoverRedirectionUrlValidationCallback), damit die AutoErmittlung der Umleitung folgen kann." Diese Ausnahme wird für alle Umleitungsantworten generiert, unabhängig von der Gültigkeit der URL, die in der Umleitungsantwort zurückgegeben wird.

Um die Umleitung zu aktivieren, verwenden Sie stattdessen die AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) -Überladung.

Gilt für:

AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)

Initialisiert die Url -Eigenschaft für den EWS-Endpunkt (Exchange Web Services) für eine angegebene E-Mail-Adresse, indem der AutoErmittlungsdienst aufgerufen wird.

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)

Parameter

emailAddress
String

Die zu verwendende E-Mail-Adresse.

validateRedirectionUrlCallback
AutodiscoverRedirectionUrlValidationCallback

Der Rückruf, der zum Überprüfen der Umleitungs-URL verwendet wird.

Ausnahmen

Ein lokaler Fehler, z. B. eine blockierte Umleitung oder eine Anzahl von Umleitungen, die größer als der Höchstwert sind, führte dazu, dass die AutoErmittlung beendet wurde.

Der AutoErmittlungsserver hat einen Fehler zurückgegeben.

Im Parameter wurde ein leerer emailAddress Wert übergeben.

Beispiele

Das folgende Beispiel zeigt, wie Sie die EWS-URL des Benutzers mithilfe der AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) -Methode abrufen.

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

Hinweise

Diese Methode ermöglicht es der AutoErmittlung, Umleitungen zu folgen, wenn ein AutoErmittlungsserver mit dem Umleitungsstatus 302 antwortet.

Gilt für: