Sharepoint应用EWSManagedAPI操作Exchange邮箱

renyanping

　　在sharepoint定制开发中，可能会有读取用户邮件并显示的Webpart需求，
　　本文是对如何使用EWS Managed API操作Exchange邮箱进行的整理和总结。

一、认识EWS Managed API
　　EWS Managed API是微软开发用于客户端开发Exchange的应用程序接口，与.Net Framework
　　类库一样，简单直观的提供Exchange资源的统一访问。

二、如何在sharepoint项目中使用EWS Managed API
　　如何将此类库加入我们的sharepoint项目，可以看我之前的一篇博客  Sharepoint添加EWSManagedAPI引用
　　在此就不再讲述。

三、sharepoint项目中的具体应用
　　下面的内容是我根据最近我遇到的项目来讲述具体的应用。
　　3.1 首先实例化一个ExchangeService对象，并获取收件箱中的内容。



            ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback(CheckValidationResult);
ExchangeService service = new ExchangeService(ExchangeVersion.Exchange2010);//如果是Exchange 2010，则切换到2010
ICredentials creds = new NetworkCredential(username, password, "域名");
service.Credentials = new WebCredentials(creds);
service.Url = new Uri("https://服务器地址/ews/exchange.asmx");
service.PreAuthenticate = true;
            //完成实例化
ItemView view = new ItemView(10);
view.OrderBy.Add(ItemSchema.DateTimeReceived, Microsoft.Exchange.WebServices.Data.SortDirection.Descending);
Microsoft.Exchange.WebServices.Data.EmailMessage em = null;
FindItemsResults<Item> findMailResults = service.FindItems(WellKnownFolderName.Inbox, view);foreach (Item m in findMailResults)
{
em = (Microsoft.Exchange.WebServices.Data.EmailMessage)m;
                //对em邮件的操作
}
ServicePointManager.ServerCertificateValidationCallback这一句用于设置用于验证服务器证书的回调，然后实例化一个ExchangeService对象，创建一个web验证凭据creds，
并将此凭据赋给service.Credentials。Url这个属性可以直接用Exchange服务器中的服务地址，也可以用ExchangeService中的AutodiscoverUrl方法，只需提供一个Exchange服务器地址
即可，ExchangeService会自动根据服务器地址找到对应的服务。
ItemView用于设置邮件视图，包括大小和排序规则。从Inbox中取出邮件后，用循环取得邮件并进行相应的操作。

　　3.2 读取任务文件夹中的内容
　　实例化与上面的相同，不同在于访问的文件夹不同



            FindItemsResults<Item> findResults = service.FindItems(WellKnownFolderName.Tasks, view); //读取任务文件夹
Microsoft.Exchange.WebServices.Data.Task t = null;foreach (Item item in findResults.Items)
{
t = (Microsoft.Exchange.WebServices.Data.Task)(item);
if (!t.IsComplete)
{
                    //具体操作代码

}
}
　　上述内容是立即应用的代码，根据需要取得的数据不同，访问的文件也不用。
　　在使用Microsoft.Exchange.WebServices.Data过程中，发现此枚举包含很多类型，根据不同的需求，只要访问不同的类型就可以完成数据查询。
　　3.3 获取OwaID
　　有时我们需要在用户点击相应链接后跳转到Owa邮件页面，在拼接URL是会遇到无法获取owaid（url中的id字符串）,下面附上相应代码



  public String GetOutlookOwaId(EmailMessage message, ExchangeService ser)
{
AlternateId ewsId = new AlternateId(IdFormat.EwsId, message.Id.ToString(), "用户邮件地址如：**@exchange.com");
AlternateIdBase owaId = ser.ConvertId(ewsId, IdFormat.OwaId);
return ((AlternateId)owaId).UniqueId;
}
　　
　　读取邮箱中数据的操作基本就是这些了，下一篇博客会写一下基于SharePoint  Secure Store Service服务实现用户owa邮箱的模拟单点登录。请有这方面需求的观众关注。