Définir l’URL du service EWS à l’aide de l’API managée EWS

  • Article

Trouver des informations sur la manière de définir l’URL du service EWS dans votre application API managée EWS.

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.

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.

Définir l'URL du service EWS en utilisant le service de découverte automatique

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.

// 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 Exchange

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.

// 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 aussi