读取Exchange邮件或任务(1)--通过Exchange Web Service

 

企业邮件系统Exchange往往会与企业业务协作平台SharePoint一起搭配使用，如在SharePoint企业门户上显示当前登录用户所有未读邮件或最新的待办任务信息等，以便于用户可以在门户上选择未读邮件或待办任务直接打开Exchange邮件系统显示信息的正文，而不需要用户再去通过OutLook客户端或OWA方式去登录邮件系统去查看信息，从而提高了工作效率。

 

而要在SharePoint门户上显示邮件系统上未读邮件或任务需要通过代码编程来实现，将这个功能开发成一个自定义的WebPart后部署到门户上去。

 

接下来介绍如何通asp.net代码来读取Exchange邮件或任务：通过Exchange Web Service、Exchange Web Services Managed API

 

一、通过Exchange Web Service来读取

 

1、首先，在项目上添加Web Service引用，这个Web Service的URL 地址格式如：https://Exchange邮件系统的服务器名/EWS/Exchange.asmx

 

2、引入如下命名空间：

using System.Net;

using System.Net.Security;

using System.Security.Cryptography.X509Certificates;

 

3、编写代码读取邮件信息：

 

             // 忽略SSL证书请求必须的，不添加在执行时会报错，错误信息好像是（记不清了)“客户端响应错误………html / text”
            ServicePointManager.ServerCertificateValidationCallback  =
                     delegate (Object obj, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors)
                    {  return   true ; };

             // 创建Exchange服务绑定对象
                ExchangeServiceBinding exchangeServer  =   new  ExchangeServiceBinding();
             // 创建安全身份凭证
                ICredentials creds  =   new  NetworkCredential( " username " ,  " password " ,  " domain " );
             // 建立信任连接
                exchangeServer.Credentials  =  creds;
                exchangeServer.Url  =   " https://Exchange邮件系统的服务器名/EWS/Exchange.asmx " ;
            
             // 定义邮件的收件箱
                DistinguishedFolderIdType[] folderIDArray  =   new  DistinguishedFolderIdType[ 1 ];
                folderIDArray[ 0 ]  =   new  DistinguishedFolderIdType();
                folderIDArray[ 0 ].Id  =  DistinguishedFolderIdNameType.inbox;  // 读取inbox文件夹下所有邮件，不包括子文件夹
             // folderIDArray[0].Id = DistinguishedFolderIdNameType.tasks; // 读取Task文件夹下的所有任务，不包括子文件夹

             // 设置要读取所需满足的条件
                PathToUnindexedFieldType ptuftDisplayName  =   new  PathToUnindexedFieldType();
                ptuftDisplayName.FieldURI  =  UnindexedFieldURIType.folderDisplayName;

                PathToExtendedFieldType pteftComment  =   new  PathToExtendedFieldType();
                pteftComment.PropertyTag  =   " 0x3004 " ; 
                pteftComment.PropertyType  =  MapiPropertyTypeType.String;

                GetFolderType myfoldertype  =   new  GetFolderType();
                myfoldertype.FolderIds  =  folderIDArray;
                myfoldertype.FolderShape  =   new  FolderResponseShapeType();
                myfoldertype.FolderShape.BaseShape  =  DefaultShapeNamesType.IdOnly;
                myfoldertype.FolderShape.AdditionalProperties  =   new  BasePathToElementType[ 2 ];
                myfoldertype.FolderShape.AdditionalProperties[ 0 ]  =  ptuftDisplayName;
                myfoldertype.FolderShape.AdditionalProperties[ 1 ]  =  pteftComment;
            
             // 获取Exchange邮件系统中指定类型文件夹信息
                GetFolderResponseType myFolder  =  exchangeServer.GetFolder(myfoldertype);

                FolderInfoResponseMessageType firmtInbox  =
                    (FolderInfoResponseMessageType)myFolder.ResponseMessages.Items[ 0 ];

                PathToUnindexedFieldType ptuftSubject  =   new  PathToUnindexedFieldType();
                ptuftSubject.FieldURI  =  UnindexedFieldURIType.itemSubject;

                PathToUnindexedFieldType ptuftBody  =   new  PathToUnindexedFieldType();
                ptuftBody.FieldURI  =  UnindexedFieldURIType.itemAttachments;

                PathToExtendedFieldType pteftFlagStatus  =   new  PathToExtendedFieldType();
                pteftFlagStatus.PropertyTag  =   " 0x1090 " ; 
                pteftFlagStatus.PropertyType  =  MapiPropertyTypeType.Integer;

             //   定义FindItemType对象，准备获取收件箱中的集合
                FindItemType findItemRequest  =   new  FindItemType();
                findItemRequest.Traversal  =  ItemQueryTraversalType.Shallow;
                findItemRequest.ItemShape  =   new  ItemResponseShapeType();
                findItemRequest.ItemShape.BaseShape  =  DefaultShapeNamesType.Default;

                findItemRequest.ParentFolderIds  =   new  FolderIdType[ 1 ];
                findItemRequest.ParentFolderIds[ 0 ]  =  firmtInbox.Folders[ 0 ].FolderId;

             // 获取指定收件箱中的邮件集合
                FindItemResponseType firt  =  exchangeServer.FindItem(findItemRequest);

                MessageType mt  =   new  MessageType();   // 邮件类型
                 int  newEmail  =   0 ; // Unread email number
                 foreach  (FindItemResponseMessageType firmtMessage  in  firt.ResponseMessages.Items)
                {
                     if  (firmtMessage.RootFolder.TotalItemsInView  >   0 )
                    {
                         foreach  (ItemType it  in  ((ArrayOfRealItemsType)firmtMessage.RootFolder.Item).Items)
                        {
                            mt  =  it  as  MessageType;
                             if  (mt  !=   null )
                            {
                                 // this.TextBox1.Text += string.Format(string.Format("是否已读: {0} <br>", mt.IsRead.ToString()));
                                 if  ( ! mt.IsRead)  // 判断邮件是否是已读还是未读
                                    newEmail ++ ;
                                 else
                                     continue ;
                            }

                             #region  Eg codes

                            Response.Write( string .Format( " <br><br>标题: {0} <br> " , it.Subject));
                            Response.Write( string .Format( " <br><br>标题: {0} <br> " , it.Subject)  +   string .Format( " 发件人: {0} <br> " , mt.From.Item.Name.ToString()));
                            
                             #endregion
                        }

                        Response.Write(newEmail.ToString());

                    }
                }

 

4、运行程序读取邮件或任务信息

 

如上介绍了通过Exchange Web Service方法来读取未读邮件或任务，在下一篇中将介绍另外一种方式通过Exchange Web Services Managed API来实现这个功能......