Sharepoint应用EWSManagedAPI操作Exchange邮箱

在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邮箱的模拟单点登录。请有这方面需求的观众关注。