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(“

hello word

”)

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
返回邮件正文。response.write (message.body)


bodytext():string
返回全部的文本正文。response.write (message.bodytext)

charset():string
设置邮件使用的字符集。默认为us-ascii,支持中文则设置为gb2312。

contenttransferencoding():string
设置邮件编码。默认为：quoted-printable.

contenttype():string
返回正文类型。

date():date
返回邮件发送时间。

deferreddelivery():date
设置邮件定时发送。

encoding():string
设置附件的默认编码：base64或quoted-printable

encryptattachments():boolean
设置为true时，所有的附件都被加密，当然是编译器可用的情况下。其默认值为true.

errorcode():integer
如果message.silent设置为true时，该函数包含错误号。

erroemessage():string
如果message.silent设置为true时，该函数包含错误描述。

erroesource():string
如果message.silent设置为true时，该函数包含错误来源。

from():string
返回或设置发件人的email地址。

fromname():string
返回或设置发件人的名字。

htmlbody():string
返回或设置邮件正文的html部分。

isoencodeheaders():boolean
邮件头是否使用iso-8859-1编码。（默认为true）

log():string
当logging为true时，该函数返回创建的日志。

logging():boolean
是否启用日志。message.logging=true时，启用日志。

maildata():string
返回邮件的源代码。

maildomain():string
设置发送邮件时使用的邮件服务器。

mailserverpassword():string
当邮件服务器使用smtp发信认证时，该函数设置登录密码。

mailserverusername():string
当邮件服务器使用smtp发信认证时，该函数设置登录帐号。

mimeversion():string
声明mime版本，默认为1.0。

mspickupdirectory():string
指定ms smtp服务的pickup文件夹的位置。

pgpencrypt():boolean
当邮件是使用pgp发送时并该属性被设置为true时，该邮件将被自动加密。

pgpsign():boolean
当邮件是使用pgp发送时并该属性被设置为true时，该邮件将被自动签名。

priority():byte
设置邮件的优先级：1、2和3

recipients():pointer
返回收件人集合。

recipientsstring():string
返回收件人集合（只读）。

replyto():string
指定一个回复地址。

silent():boolean
当设置为true时，send()方法就会忽略错误并不将错误信息返回给操作系统。

simplelayout():boolean
当设置为true时，发信时jmail不会添加邮件头到邮件里。

size():integer
返回邮件的总字节数。

subject():string
设置邮件标题。

text():string
返回完整的邮件内容。

version():string
返回jmal的版本信息。




4、 headers对象

属性（或方法）
描述

getheader(headername):string
返回指定的邮件头的值。

text():string
返回所有的邮件头的值。




5、 recipients对象

属性（或方法）
描述

add(value)
追加一个收件人到集合中。

clear()
清除集合中的全部记录。

count():integer
返回集合中收件人的总数。

item(index):pointer
返回集合中的一个指定的收件人。




6、 recipient对象

属性（或方法）
描述

new(name,email,recipienttype):pointer
创建一个可以添加到收件人集合中recipients的收件人。

email():string
返回收件人的邮件。

name():string
返回收件人的姓名。

retype():integer
返回收件人模式（收件人to=0,抄送cc=1,暗送bcc=2）。




7、 attachments对象

属性（或方法）
描述

add(attachment)
添加一个附件到集合。

clear()
清除集合中的全部附件。

count():integer
返回集合中附件的总数。

item(index):pointer
返回集合中指定的附件。