As you might have seen, we announced last week that the Exchange Web Services Managed API is now available as a beta download. I’ve been working with the API internally for about a year now and I must say, if you are writing .NET code that uses Exchange Web Services there’s no better way to do it. I’ve been working on an Exchange browser application, similar to MFCMAPI which started out leveraging the auto-generated proxy classes. Switching this project over to the EWS Managed API cut down hundreds of lines of code and improved the readability and organization of the code immensely. (Stay tuned for more information on this project…)
“The EWS Managed API is a fully object-oriented API that provides the experience developers have come to expect from Visual Studio and the Microsoft .NET Framework. Built on the EWS XML protocol, it provides an easy-to-learn, easy–to-use, and easy-to-maintain .NET interface to Exchange Web Services that both beginner and advanced developers will find to be an improvement over autogenerated proxies.
The API at it’s simplest is just a set of proxy classes for interacting with Exchange – they still generate the same Exchange Web Services SOAP XML that the auto-generated proxy classes do or that your code that doesn’t use proxy classes do. The difference is that this API is easy to use, understand, and has some additional business logic included. The release of this API doesn’t change the support or our recommendations towards use of Exchange Web Services in their raw form.
Here are Matt’s three rules for getting started:
- Check out David Claux’s introduction for the API on MSDN as well as the “Working with…” section of the MSDN reference.
- Don’t confuse the Exchange Web Services Managed Reference with the EWS Managed API Reference. The Exchange Web Services Managed Reference in the MSDN is reference of the auto-generated proxy classes.
- For the sake of my sanity please don’t start calling this the EWS MAPI – it’s the EWS Managed API, the EWS API, the EWS Client API, The API, Managed EWS, anything you want that doesn’t involve acronyms shared with other Exchange APIs. (I guess I should be happy they didn’t call it EWS CDO, right?)