Configurando seu ambiente de desenvolvimento de aplicativos do ExchangeSetting up your Exchange application development environment

Saiba como configurar seu ambiente de desenvolvimento para criar um aplicativo EWS que se comunica com o Exchange.Learn about how to set up your development environment to create an EWS application that communicates with Exchange.

Antes de começar a escrever seu aplicativo de serviços Web do Exchange (EWS), você precisará certificar-se de que seu ambiente de desenvolvimento atende a alguns requisitos mínimos.Before you start writing your Exchange Web Services (EWS) application, you'll need to make sure that your development environment meets a few minimum requirements. Você pode usar a API gerenciada do EWS, a API de acesso para cliente padrão para aplicativos do .NET Framework, para desenvolver seu aplicativo, ou você pode usar o EWS sozinho, com nosso sem um proxy autogerado.You can use the EWS Managed API, the standard client access API for .NET Framework applications, to develop your application, or you can use EWS on its own, with our without an autogenerated proxy. Em geral, recomendamos que você use a API gerenciada do EWS; no entanto, você pode explorar a diferença entre essas duas opções em mais detalhes para descobrir qual é a melhor para você.In general, we recommend that you use the EWS Managed API; however, you can explore the difference between these two options in more detail to find out which one is right for you.

Observação

A API gerenciada do EWS já está disponível como um projeto de código-fonte aberto no GitHub.The EWS Managed API is now available as an open source project on GitHub. É possível usar a biblioteca de software livre para:You can use the open source library to:

  • Contribui com correções de bug e melhorias à API.Contribute bug fixes and enhancements to the API.
  • Obtenha correções e melhorias antes que estejam disponíveis em uma versão oficial.Get fixes and enhancements before they are available in an official release.
  • Acesse a implementação mais abrangente e atualizada da API, para usar como referência ou criar novas bibliotecas em novas plataformas. Access the most comprehensive and up-to-date implementation of the API, to use as a reference or to create new libraries on new platforms.

Agradecemos suas contribuições via github.We welcome your contributions via GitHub.

Ambiente de desenvolvimento para a API gerenciada do EWSDevelopment environment for the EWS Managed API

Para criar um aplicativo da API gerenciada por EWS, você precisará de acesso ao seguinte:To create an EWS Managed API application, you'll need access to the following:

  • A API gerenciada do EWS.The EWS Managed API.

    Você pode armazenar os arquivos da API gerenciada do EWS em qualquer lugar no computador; Por padrão, eles são instalados na pasta Program Files\Microsoft\Exchange\Web Services \<version number > .You can store the EWS Managed API files anywhere on your computer; by default, they are installed in the Program Files\Microsoft\Exchange\Web Services\<version number> folder.

  • Uma caixa de correio em um servidor do Exchange que está executando o Exchange Online, o Exchange Online como parte do Office 365, ou uma versão do Exchange a partir do Exchange Server 2007.A mailbox on an Exchange server that is running Exchange Online, Exchange Online as part of Office 365, or a version of Exchange starting with Exchange Server 2007.

    Você pode obter um plano de negócios do Exchange Online, incluindo uma avaliação gratuita, no site do Office 365.You can get an Exchange Online plan for business, including a free trial, from the Office 365 site. Para se conectar à caixa de correio, você deve ter o nome de usuário e as credenciais da conta associada à caixa de correio.In order to connect to the mailbox you must have the user name and credentials of the account associated with the mailbox.

  • Uma versão do Visual Studio que começa com o Visual Studio 2005.A version of Visual Studio starting with Visual Studio 2005. Se você não tiver o Visual Studio no momento, poderá baixar uma versão gratuita.If you don't currently have Visual Studio, you can download a free version.

  • Uma versão do .NET Framework começando com o .NET Framework 3,5.A version of the .NET Framework starting with the .NET Framework 3.5. Você pode baixar o .NET Framework 3,5 no centro de download da Microsoft.You can download the .NET Framework 3.5 from the Microsoft Download Center.

Além disso, será útil se você tiver alguma familiaridade com C#.In addition, it is helpful if you have some familiarity with C#. Embora o Visual Studio ofereça suporte a outros idiomas além do C#, a maior parte do código de exemplo disponível para a API gerenciada do EWS é escrita em C#.Although Visual Studio supports other languages in addition to C#, most of the sample code available for the EWS Managed API is written in C#.

Ambiente de desenvolvimento para EWSDevelopment environment for EWS

Você pode usar o EWS para desenvolver seu aplicativo de algumas maneiras diferentes.You can use EWS to develop your application in a couple of different ways. A maneira mais simples de usar o EWS é criar arquivos de texto que contenham suas solicitações XML e transmiti-las para o Exchange.The simplest way to use EWS is to create text files that contain your XML requests, and transmit them to Exchange. Para fazer isso, aqui está o que você precisa:To do this, here is what you need:

  • Um editor de texto simples, como o bloco de notas, para editar sua solicitação XML.A simple text editor, like Notepad, to edit your XML request. Qualquer editor de texto fará, embora você possa desejar um que irá ajudar na sua validação de sintaxe XML, como XMetal.Any text editor will do, although you might want one that will help with your XML syntax validation like XMetal.

  • Uma ferramenta ou um aplicativo que pode enviar e receber solicitações e respostas XML do SOAP, a fim de se comunicar com o Exchange.A tool or application that can send and receive SOAP XML requests and responses, in order to communicate with Exchange.

Ao trabalhar com XML bruto, também é útil ter uma compreensão básica da formatação XML.When you work with raw XML, it's also helpful to have a basic understanding of XML formatting.

A segunda maneira de usar o EWS é criar um proxy gerado automaticamente que permite que você trabalhe com as operações usando uma linguagem .NET como C#.The second way to use EWS is to create an autogenerated proxy that enables you to work with the operations by using a .NET language like C#. Veja o que você precisa para trabalhar com um proxy autogerado:Here is what you need to work with an autogenerated proxy:

  • Uma versão do Visual Studio que começa com o Visual Studio 2005, para criar uma referência de proxy.A version of Visual Studio starting with Visual Studio 2005, to create a proxy reference. Você pode baixar uma versão gratuita.You can download a free version.

  • Uma versão do .NET Framework começando com o .NET Framework 2,0.A version of the .NET Framework starting with the .NET Framework 2.0. Você pode baixar o .NET Framework 3,5 no centro de download da Microsoft.You can download the .NET Framework 3.5 from the Microsoft Download Center.

Se você usar um proxy gerado automaticamente, convém ter alguma familiaridade com programação C#.If you use an autogenerated proxy, you'll want to have some familiarity with C# programming.

Observação

Se você é um desenvolvedor do .NET Framework, recomendamos que você use a API gerenciada do EWS em vez de proxies gerados automaticamente para desenvolver contra o EWS.If you're a .NET Framework developer, we encourage you to use the EWS Managed API rather than autogenerated proxies to develop against EWS. O modelo de objeto da API gerenciada do EWS é mais fácil de usar do que os modelos de objeto proxy gerados automaticamente.The EWS Managed API object model is easier to use than autogenerated proxy object models. Além disso, a API gerenciada do EWS implementa a descoberta automática e inclui a lógica do lado do cliente.Also, the EWS Managed API implements Autodiscover and includes client-side logic.

Confira tambémSee also