ExchangeService.AutodiscoverUrl Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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.