Compartilhar via


Definir a URL do serviço EWS usando a API gerenciada do EWS

Encontre informações sobre como definir a URL do serviço do EWS em seu aplicativo de API gerenciada do EWS.

A URL do serviço é o endereço que o Exchange usa para se comunicar com os serviços Web do Exchange (EWS). Após o aplicativo da API gerenciada do EWS ter esse endereço e ter acesso apropriado para se comunicar com o EWS, ele pode fazer chamadas para a classe ExchangeService. A URL de serviço de um servidor Exchange local pode ter a aparência a seguir.

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

Você pode definir a URL do EWS em seu aplicativo de algumas maneiras. Recomendamos que você use o serviço de descoberta automática para obter a URL porque, em uma grande floresta de servidores, a URL poderá ser alterada se a caixa de correio for migrada para outro servidor. No entanto, como chamar a descoberta automática pode levar algum tempo e reduzir o aplicativo se você precisar fazer várias chamadas em um curto período de tempo, talvez queira armazenar em cache o valor da URL obtido da descoberta automática e definir manualmente a URL do serviço do EWS com esse valor em cache. Isso melhorará o desempenho do seu aplicativo; Apenas certifique-se de usar a descoberta automática para atualizar o valor em cache periodicamente, caso o valor mude no servidor.

Definir a URL do serviço do EWS usando o serviço de descoberta automática

O método AutodiscoverUrl usa o endereço de email para definir o ponto de extremidade ExchangeService e permite que seu aplicativo use qualquer método incluído nas classes de proxy do ExchangeService . O exemplo a seguir mostra como usar o método 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");

Definir a URL do serviço do Exchange manualmente

O exemplo a seguir mostra como definir a URL do serviço do EWS usando um valor em cache. Antes de fazer isso, certifique-se de usar o serviço de descoberta automática para obter a URL do 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");

Confira também