Définir l’URL du service EWS à l’aide de l’API managée EWSHow to: Set the EWS service URL by using the EWS Managed API

Trouver des informations sur la manière de définir l’URL du service EWS dans votre application API managée EWS.Find information about how to set the EWS service URL in your EWS Managed API application.

L'URL du service est l'adresse qu'Exchange utilise pour communiquer avec les services web Exchange (EWS). Une fois que votre application d'API managée EWS a cette adresse et qu'elle dispose d'un accès approprié pour communiquer avec EWS, elle peut effectuer des appels vers la classe ExchangeService. L'URL du service pour un serveur Exchange local peut se présenter comme suit.The service URL is the address that Exchange uses to communicate with Exchange Web Services (EWS). After your EWS Managed API application has this address, and has appropriate access to communicate with EWS, it can make calls to the ExchangeService class. The service URL for an on-premises Exchange server might look like the following.

https://computer.domain.contoso.com/EWS/Exchange.asmx

Vous pouvez définir l'URL EWS dans votre application de deux manières. Nous vous conseillons d'utiliser le service de découverte automatique pour obtenir l'URL, car dans une vaste forêt de serveurs, l'URL peut changer si la boîte aux lettres est migrée vers un autre serveur. Toutefois, comme l'appel du service de découverte automatique peut prendre du temps et ralentir votre application, si vous devez effectuer plusieurs appels sur une courte période, vous devrez peut-être mettre en cache la valeur de l'URL obtenue grâce à la découverte automatique et définir manuellement l'URL du service EWS à l'aide de cette valeur mise en cache. Cela améliore les performances de votre application ; veillez simplement à utiliser la découverte automatique pour mettre à jour régulièrement la valeur mise en cache, au cas où la valeur soit modifiée sur le serveur.You can set the EWS URL in your application in a couple of ways. We recommend that you use the Autodiscover service to get the URL because in a large forest of servers, the URL can change if the mailbox is migrated to another server. However, because calling Autodiscover can take some time and can slow down your application if you need to make multiple calls in a short period of time, you might want to cache the URL value you get from Autodiscover and manually set the EWS service URL with this cached value. This will improve the performance of your application; just make sure that you use Autodiscover to update your cached value periodically in case the value changes on the server.

Définir l'URL du service EWS en utilisant le service de découverte automatiqueSet the EWS service URL by using the Autodiscover service

La méthode AutodiscoverUrl utilise l'adresse électronique pour définir le point de terminaison ExchangeService et elle permet à votre application d'utiliser toutes les méthodes incluses dans les classes proxy ExchangeService. L'exemple qui suit illustre l'utilisation de la méthode AutodiscoverURL.The AutodiscoverUrl method uses the email address to set the ExchangeService endpoint and enables your application to use any methods included in the ExchangeService proxy classes. The following example shows how to use the AutodiscoverURL method.

// Create the binding.
ExchangeService service = new ExchangeService();
// Set the credentials for the on-premises server.
service.Credentials = new WebCredentials("user1@contoso.com", "password");
// Set the URL.
service.AutodiscoverUrl("User1@contoso.com");

Définir manuellement l'URL du service ExchangeSet the Exchange service URL manually

L'exemple qui suit illustre la définition de l'URL du service EWS à l'aide d'une valeur mise en cache. Avant cela, veillez à utiliser le service de découverte automatique pour obtenir l'URL EWS.The following example shows you how to set the EWS service URL by using a cached value. Before you do this, make sure to use the Autodiscover service to get the EWS URL.

// Create the binding.
ExchangeService service = new ExchangeService();
// Set the credentials for the on-premises server.
service.Credentials = new WebCredentials("user1@contoso.com", "password");
// Set the URL.
service.Url = new Uri("https://computername.domain.contoso.com/EWS/Exchange.asmx");

Voir aussiSee also