Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

Setting the Exchange service URL by using the EWS Managed API

To use the Microsoft Exchange Web Services (EWS) Managed API, you must set the Exchange Service URL. You can provide the appropriate service binding manually, or by using the AutodiscoverUrl method. The AutodiscoverUrl method initializes the Url property to the Exchange Web Services URL for the specified email address by calling the Autodiscover service.

We recommend that you use the Autodiscover service because the Autodiscover service determines the best endpoint for a specific user. When you use the Autodiscover service, if the EWS URL changes, your code will not be affected.

  • Set the EWS URL. Before you can do this, determine the EWS URL by using the Autodiscover service.

    C#
    Copy 
    // Create the binding.
ExchangeService service = new ExchangeService();
service.Credentials = new WebCredentials("UserName", "password", "domain.contoso.com");

// Set the URL.
service.Url = new Uri("https://computername.domain.contoso.com/EWS/Exchange.asmx");

  • The AutodiscoverUrl method uses the email address to set the ExchangeService endpoint and enables the mailbox user to perform any methods of the ExchangeService proxy classes.

    C#
    Copy 
    // Create the binding.
ExchangeService service = new ExchangeService();
service.Credentials = new WebCredentials("UserName", "password", "domain.contoso.com");

// Set the URL.
service.AutodiscoverUrl("User1@contoso.com");

  • After you obtain the URL for the Exchange server endpoints, you can communicate with the Exchange mailbox. The Exchange Service Url property is similar to the following.

    C#
    Copy 
    https://computer.domain.contoso.com/EWS/Exchange.asmx

For information about compiling this code, see Getting started with the EWS Managed API.

  • Write appropriate error handling code for common search errors.
  • Review the client request XML sent to the Exchange server.
  • Review the server response XML sent from the Exchange server.
  • Set the service binding as shown in Setting the Exchange service URL by using the EWS Managed API. Do not hard code URLs because if mailboxes move, they might be serviced by a different Client Access server. If the client cannot connect to the service, retry setting the binding by using the AutodiscoverUrl method.
  • Use HTTP with SSL for all communication between client and server.
  • Always validate the server certificate that is used for establishing the SSL connections. For more information, see Validating X509 certificates.
  • Do not include user names and passwords in trace files.
  • Autodiscover lookups that use HTTP GET to find an endpoint should always prompt for user confirmation; otherwise, they should be blocked.
Did you find this helpful?
(1500 characters remaining)