C# 利用Jmail接收邮件（属性说明）

W3 JMail 邮件组件是Dimac公司开发的用来完成邮件的发送、接收、加密和集群传输等工作的。w3 Jmail组件是国际最为流行的邮件组件之一，当今世界上绝大部分ASP程序员都在使用w3 Jmail组件构建邮件发送系统，那是因为w3 Jmail组件使用了新的内核技术，使其更加可靠和稳定。

一、下面向读者介绍w3 Jmail4.3组件的新特性：

1、   w3 Jmail4.3组件重新设计了其内部结构——使用Message对象代替原来的单一对象Jmail.smtpmail发送邮件；

2、   w3 Jmail4.3组件一共有十多个对象（后面将详细介绍）——这些对象中，绝大多数是针对Jmail.Message对象操作的；

3、   支持从POP3邮件服务器收取邮件；

4、   支持加密邮件的传输；

5、   快速发送，一次会话就完成邮件发送；

6、   还有一个特性就是可以使用w3 Jmail4.3组件的集群发送功能一次发送成千上万个邮件，还可以通过邮件合并（mailmerge）对象来个性化邮件。

二、Jmail邮件组件的安装及卸载：

1、   安装

跟使用别个组件一样，在使用Jmail邮件组件之前要先安装或注册该组件Jmail.dll。具体注册方法，是先把Jmail.dll文件拷贝到硬盘的某一目录下（如C:/Jmail/Jmail.dll），然后执行命令Regsvr32 C:/Jmail/Jmail.dll即可。

2、   卸载

卸载组件是安装组件的相反动作，可以使用参数/U来卸载已安装的组件，执行命令Regsvr32 /U  Jmail.dll即可。

三、详细介绍W3 Jmail组件的对象（12个）:

1、.POP3对象

属性（或方法）
 说明
 
Connect(Username,Password,Server,Port)
 连接POP3服务器，断口可选，默认110。
 
DeleteMessages()
 从邮件服务器上删除所有邮件。
 
DeleteSingleMessage(MessageID)
 从邮件服务器上删除由MessageID指定的邮件。
 
Disconnect()
 关闭跟邮件服务器的连接。
 
DownloadHeaders()
 从邮件服务器上读取所有的邮件头并传递给Messages集合。
 
DownloadMessages()
 从邮件服务器读取所有邮件。
 
DownloadSingleHeader(MessageID)
 从邮件服务器读取指定的邮件头并传递给Messages集合。
 
DownloadUnreadMessages()
 从邮件服务器上读取所有未读邮件。
 

 

2、.Messages对象

属性（或方法）
 说明
 
Clear()
 清除集合中的所有内容，并不会删除邮件服务器上的任何邮件。
 
Count():Integer
 返回集合中记录的数目：I=Messages.Count
 
Item(Index):Pointer
 返回一个Message对象。Set oMsg=Messages.Item(0)
 

 

3、.Message对象

属性（或方法）
 说明
 
AddAttachment(FileName,isInline,ContentType):String
 给邮件添加一个文件型的附件。isInline设置为True时，添加的这个附件就是一个可嵌入的附件。
 
AddCustomAttachment(FileName,Data,isInline):String
 给邮件添加一个自定义类型的附件。
 
AddHeader(Xheader,Value)
 给邮件添加一个自定义邮件头X-Header。
 
AddNativeHeader(Header,Value)
 给邮件添加一个邮件头。
 
AddRecipient(emailAddress,recipientName,PGPKey)
 给邮件添加一个收件人。RecipientName和PGPKey是可选项，RecipientName为收件人姓名，PGPKey给邮件加密。
 
AddRecipientBCC(emailAddress,PGPKey)
 添加一个邮件暗送人（BCC）地址。
 
AddRecipientCC(emailAddress,recipientName,PGPKey)
 给邮件添加一个邮件抄送人（CC）地址。
 
AddURLAttachment(bstrURL,bstrAttachAs,isInline,bstrAuth):String
 从指定的URL下载文件并添加为邮件附件。参数bstrAttachAs是用来更改添加为邮件附件的文件名。
 
AppendBodyFromFile(FileName)
 清除邮件正文，并把指定文件的内容作为邮件正文。
 
AppendHTML(Text)
 从邮件追加HTML格式正文，如例所示：Message. AppendHTML(“<H3>Hello Word</H3>”)
 
AppendText(Text)
 向邮件添加文本正文。
 
Clear()
 清除所有邮件消息，是成为一个空对象。
 
ClearAttachments()
 清除附件列表。如：Message.ClearAttachments
 
ClearCustomHeaders()
 清除所有自定义的邮件头。
 
ClearRecipients()
 清除所有收件人地址列表。
 
Close()
 释放Jmail与邮件服务器连接而使用的缓存（Cache）。
 
DecodeHeader(Header):String
 输出一个邮件头消息。
 
ExtractEmailAddressesFromURL(bstrURL,bstrAuth)
 从指定的网制（URL）读取并添加邮件列表。
 
GetMessageBodyFromURL(同上)
 删除邮件正文并用指定的URL的内容代替。
 
KeyInformation(keyIdentifier):pointer
 返回一个PGPKey对象。
 
LoadFromStream(Stream)
 从数据库流读取数据，该数据库流必须符合RFC822标准。
 
LogCustomMessage(Message)
 给Jmail日志文件添加自定义日志。此函数只有在logging属性被设置为True时有效。
 
Nq()
 将邮件追加到发送队列等待发送。
 
ParseMessage(MessageSource)
 解析一个邮件，数据流必须符合RFC822格式标准。
 
SaveToStream(Stream)
 保存邮件到数据流，数据流必须符合RFC822格式标准。
 
Send(MailServer,enque):Boolean
 发送邮件。邮件服务器是一个描述邮件服务器名称或地址的字符串，用户名和密码是可选项。当要发送认证邮件时使用格式为：用户名:密码@邮件服务器
 
SendToNewsGroup(ServerName,NewsGroup)
 使用指定的ＮＮＴＰ服务器发送邮件到新闻组，多个邮件用“,”隔开。
 
About():string
 设置一些附加信息。
 
Attachments():Pointer
 返回邮件的附件集合。Set Attachments=Message.Attachments
 
Body():String
 

 1 /**/ /// <summary>
 2  /// 利用JMAIl接收邮件
 3  /// </summary>
 4  /// <param name="mailname">油箱用户名称</param>
 5  /// <param name="mailpwd">油箱密码</param>
 6  /// <param name="poptity">等级</param>
 7  /// <param name="senders">发送者</param>
 8  /// <param name="sendmail">发件人地址</param>
 9  /// <param name="subject">主题</param>
10  /// <param name="body">内容</param>
11  /// <param name="path">路径</param>
12  /// <param name="data">数据</param>
13  /// <param name="num1">输出参数</param>
14    public   static   void  ReciveMail( string  mailname, string  mailpwd, ref   string  poptity, ref   string  senders, ref   string  sendmail, ref   string  subject, ref   string  body, ref   string  path, ref   string  data, out   int  num1, string  paths)
15    {
16   num1=1;
17   jmail.POP3Class popMail = new jmail.POP3Class();
18   jmail.Message mailMessage; 
19   jmail.Attachments atts;
20   jmail.Attachment att;
21   string pop="pop."+mailname.Substring(mailname.IndexOf("@")+1);
22   popMail.Connect(mailname,mailpwd,pop,110);
23   if(0<popMail.Count)
24   {
25    for(int i=1;i<=popMail.Count;i++)
26    {
27     mailMessage=popMail.Messages[i];
28     atts=mailMessage.Attachments;
29     mailMessage.Charset = "GB2312";    
30     mailMessage.Encoding = "Base64"; 
31     mailMessage.ISOEncodeHeaders = false; 
32     poptity = mailMessage.Priority.ToString();
33     senders = mailMessage.FromName; 
34     sendmail = mailMessage.From; 
35     subject =mailMessage.Subject;
36     body = mailMessage.Body;  
37     data=mailMessage.Date.ToString();
38     string size = mailMessage.Size.ToString(); 
39     for(int j=0;j<atts.Count;j++)
40     {
41      if(j == 0)
42      {
43       //取得附件名称
44       att = atts[j];  
45       /**//**//**////附件名称  
46                           
47       string attname = att.Name;  
48//       int k = attname.LastIndexOf(".");
49//       string time = DateTime.Now.ToString();
50//       time = time.Replace("-",""); 
51//       time = time.Replace(" ","");
52//       time = time.Replace(":","");
53//       attname = attname.Insert(attname.LastIndexOf("."),"-"+time);  
54//       /**上传到服务器
55       //path="D://Mail//mailre//"+attname;
56       string all=paths+"//Mail//MailReceive//";
57                             path=all+attname;
58       DirectoryInfo dir=new DirectoryInfo(all);
59       
60       if(dir.Exists)
61       {
62        att.SaveToFile(path);  
63       }
64       else
65       {
66        dir.Create();
67        att.SaveToFile(path);  
68       }
69      }
70      
71       
72     }
73     popMail.DeleteSingleMessage(i);//删除邮件
74    }
75    att = null;
76    atts = null;
77    popMail.Disconnect();        
78    popMail = null;
79   }
80   else
81   {
82   
83    num1=0;
84    att = null;
85    atts = null;
86    popMail.Disconnect();        
87    popMail = null;
88   }
89                    
90   
91  }
92      
93