ExchangeService.AutodiscoverUrl Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| AutodiscoverUrl(String) |
Inicializa el Url (propiedad) al extremo de servicios Web de Exchange (EWS) para una dirección de correo electrónico especificada mediante una llamada del servicio Detección automática. |
| AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) |
Inicializa el Url (propiedad) al extremo de servicios Web de Exchange (EWS) para una dirección de correo electrónico especificada mediante una llamada del servicio Detección automática. |
AutodiscoverUrl(String)
Inicializa el Url (propiedad) al extremo de servicios Web de Exchange (EWS) para una dirección de correo electrónico especificada mediante una llamada del servicio Detección automática.
public:
void AutodiscoverUrl(System::String ^ emailAddress);public void AutodiscoverUrl (string emailAddress);Public Sub AutodiscoverUrl (emailAddress As String)Parámetros
- emailAddress
- String
La dirección de correo electrónico que se usará.
Excepciones
Un error local, como una redirección bloqueada o un número de redirecciones de mayores que el máximo, causada detección automática detener.
El servidor de detección automática devolvió un error.
Se pasó un valor vacío en el emailAddress parámetro.
Ejemplos
En el ejemplo siguiente se muestra cómo obtener la dirección URL de EWS del usuario mediante el uso de la 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);
}
Comentarios
Si un servidor de detección automática devuelve un código de estado de redirección HTTP, este método generará un AutodiscoverLocalException con la propiedad de mensaje establecida en una cadena, como "detección automática bloqueados una redirección potencialmente no segura a https://autodiscover.contoso.com/autodiscover/autodiscover.xml. Para permitir la detección automática que se deben seguir la redirección, use la AutodiscoverUrl (string AutodiscoverRedirectionUrlValidationCallback) sobrecargar. " Esta excepción se genera para todos los redirección respuestas, independientemente de la validez de la dirección URL devuelta en la respuesta de redirección.
Para habilitar la redirección, use la AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback) sobrecarga en su lugar.
Se aplica a
AutodiscoverUrl(String, AutodiscoverRedirectionUrlValidationCallback)
Inicializa el Url (propiedad) al extremo de servicios Web de Exchange (EWS) para una dirección de correo electrónico especificada mediante una llamada del servicio Detección automática.
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
La dirección de correo electrónico que se usará.
- validateRedirectionUrlCallback
- AutodiscoverRedirectionUrlValidationCallback
La devolución de llamada que se usa para validar la dirección URL de redirección.
Excepciones
Un error local, como una redirección bloqueada o un número de redirecciones de mayores que el máximo, causada detección automática detener.
El servidor de detección automática devolvió un error.
Se pasó un valor vacío en el emailAddress parámetro.
Ejemplos
En el ejemplo siguiente se muestra cómo obtener la dirección URL de EWS del usuario mediante el uso de la 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);
}
Comentarios
Este método permite la detección automática seguir las redirecciones cuando un servidor de detección automática responde con un estado de redireccionamiento 302.