w3 jmail郵件組件是dimac公司開發(fā)的用來(lái)完成郵件的發(fā)送、接收、加密和集群傳輸?shù)裙ぷ鞯?。w3 jmail組件是國(guó)際最為流行的

郵件組件之一，當(dāng)今世界上絕大部分asp程序員都在使用w3 jmail組件構(gòu)建郵件發(fā)送系統(tǒng)，那是因?yàn)閣3 jmail組件使用了新的內(nèi)核

技術(shù)，使其更加可靠和穩(wěn)定。

一、下面向讀者介紹w3 jmail4.3組件的新特性：

1、 w3 jmail4.3組件重新設(shè)計(jì)了其內(nèi)部結(jié)構(gòu)——使用message對(duì)象代替原來(lái)的單一對(duì)象jmail.smtpmail發(fā)送郵件；

2、 w3 jmail4.3組件一共有十多個(gè)對(duì)象（后面將詳細(xì)介紹）——這些對(duì)象中，絕大多數(shù)是針對(duì)jmail.message對(duì)象操作的；

3、 支持從pop3郵件服務(wù)器收取郵件；

4、 支持加密郵件的傳輸；

5、 快速發(fā)送，一次會(huì)話就完成郵件發(fā)送；

6、 還有一個(gè)特性就是可以使用w3 jmail4.3組件的集群發(fā)送功能一次發(fā)送成千上萬(wàn)個(gè)郵件，還可以通過郵件合并（mailmerge

）對(duì)象來(lái)個(gè)性化郵件。

二、jmail郵件組件的安裝及卸載：

1、 安裝

跟使用別個(gè)組件一樣，在使用jmail郵件組件之前要先安裝或注冊(cè)該組件jmail.dll。具體注冊(cè)方法，是先把jmail.dll文件拷貝到

硬盤的某一目錄下（如c:\jmail\jmail.dll），然后執(zhí)行命令regsvr32 c:\jmail\jmail.dll即可。

2、 卸載

卸載組件是安裝組件的相反動(dòng)作，可以使用參數(shù)/u來(lái)卸載已安裝的組件，執(zhí)行命令regsvr32 /u jmail.dll即可。

三、詳細(xì)介紹w3 jmail組件的對(duì)象（12個(gè)）:

1、.pop3對(duì)象

屬性（或方法）
說明

connect(username,password,server,port)
連接pop3服務(wù)器，斷口可選，默認(rèn)110。

deletemessages()
從郵件服務(wù)器上刪除所有郵件。

deletesinglemessage(messageid)
從郵件服務(wù)器上刪除由messageid指定的郵件。

disconnect()
關(guān)閉跟郵件服務(wù)器的連接。

downloadheaders()
從郵件服務(wù)器上讀取所有的郵件頭并傳遞給messages集合。

downloadmessages()
從郵件服務(wù)器讀取所有郵件。

downloadsingleheader(messageid)
從郵件服務(wù)器讀取指定的郵件頭并傳遞給messages集合。

downloadunreadmessages()
從郵件服務(wù)器上讀取所有未讀郵件。




2、.messages對(duì)象

屬性（或方法）
說明

clear()
清除集合中的所有內(nèi)容，并不會(huì)刪除郵件服務(wù)器上的任何郵件。

count():integer
返回集合中記錄的數(shù)目：i=messages.count

item(index):pointer
返回一個(gè)message對(duì)象。set omsg=messages.item(0)




3、.message對(duì)象

屬性（或方法）
說明

addattachment(filename,isinline,contenttype):string
給郵件添加一個(gè)文件型的附件。isinline設(shè)置為true時(shí)，添加的這個(gè)附件就是一個(gè)可嵌入的附件。

addcustomattachment(filename,data,isinline):string
給郵件添加一個(gè)自定義類型的附件。

addheader(xheader,value)
給郵件添加一個(gè)自定義郵件頭x-header。

addnativeheader(header,value)
給郵件添加一個(gè)郵件頭。

addrecipient(emailaddress,recipientname,pgpkey)
給郵件添加一個(gè)收件人。recipientname和pgpkey是可選項(xiàng)，recipientname為收件人姓名，pgpkey給郵件加密。

addrecipientbcc(emailaddress,pgpkey)
添加一個(gè)郵件暗送人（bcc）地址。

addrecipientcc(emailaddress,recipientname,pgpkey)
給郵件添加一個(gè)郵件抄送人（cc）地址。

addurlattachment(bstrurl,bstrattachas,isinline,bstrauth):string
從指定的url下載文件并添加為郵件附件。參數(shù)bstrattachas是用來(lái)更改添加為郵件附件的文件名。

appendbodyfromfile(filename)
清除郵件正文，并把指定文件的內(nèi)容作為郵件正文。

appendhtml(text)
從郵件追加html格式正文，如例所示：message. appendhtml(“

hello word

”)

appendtext(text)
向郵件添加文本正文。

clear()
清除所有郵件消息，是成為一個(gè)空對(duì)象。

clearattachments()
清除附件列表。如：message.clearattachments

clearcustomheaders()
清除所有自定義的郵件頭。

clearrecipients()
清除所有收件人地址列表。

close()
釋放jmail與郵件服務(wù)器連接而使用的緩存（cache）。

decodeheader(header):string
輸出一個(gè)郵件頭消息。

extractemailaddressesfromurl(bstrurl,bstrauth)
從指定的網(wǎng)制（url）讀取并添加郵件列表。

getmessagebodyfromurl(同上)
刪除郵件正文并用指定的url的內(nèi)容代替。

keyinformation(keyidentifier):pointer
返回一個(gè)pgpkey對(duì)象。

loadfromstream(stream)
從數(shù)據(jù)庫(kù)流讀取數(shù)據(jù)，該數(shù)據(jù)庫(kù)流必須符合rfc822標(biāo)準(zhǔn)。

logcustommessage(message)
給jmail日志文件添加自定義日志。此函數(shù)只有在logging屬性被設(shè)置為true時(shí)有效。

nq()
將郵件追加到發(fā)送隊(duì)列等待發(fā)送。

parsemessage(messagesource)
解析一個(gè)郵件，數(shù)據(jù)流必須符合rfc822格式標(biāo)準(zhǔn)。

savetostream(stream)
保存郵件到數(shù)據(jù)流，數(shù)據(jù)流必須符合rfc822格式標(biāo)準(zhǔn)。

send(mailserver,enque):boolean
發(fā)送郵件。郵件服務(wù)器是一個(gè)描述郵件服務(wù)器名稱或地址的字符串，用戶名和密碼是可選項(xiàng)。當(dāng)要發(fā)送認(rèn)證郵件時(shí)使用格式為：用

戶名:密碼@郵件服務(wù)器

sendtonewsgroup(servername,newsgroup)
使用指定的ｎｎｔｐ服務(wù)器發(fā)送郵件到新聞組，多個(gè)郵件用“,”隔開。

about():string
設(shè)置一些附加信息。

attachments():pointer
返回郵件的附件集合。set attachments=message.attachments

body():string
返回郵件正文。response.write (message.body)


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

charset():string
設(shè)置郵件使用的字符集。默認(rèn)為us-ascii,支持中文則設(shè)置為gb2312。

contenttransferencoding():string
設(shè)置郵件編碼。默認(rèn)為：quoted-printable.

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

date():date
返回郵件發(fā)送時(shí)間。

deferreddelivery():date
設(shè)置郵件定時(shí)發(fā)送。

encoding():string
設(shè)置附件的默認(rèn)編碼：base64或quoted-printable

encryptattachments():boolean
設(shè)置為true時(shí)，所有的附件都被加密，當(dāng)然是編譯器可用的情況下。其默認(rèn)值為true.

errorcode():integer
如果message.silent設(shè)置為true時(shí)，該函數(shù)包含錯(cuò)誤號(hào)。

erroemessage():string
如果message.silent設(shè)置為true時(shí)，該函數(shù)包含錯(cuò)誤描述。

erroesource():string
如果message.silent設(shè)置為true時(shí)，該函數(shù)包含錯(cuò)誤來(lái)源。

from():string
返回或設(shè)置發(fā)件人的email地址。

fromname():string
返回或設(shè)置發(fā)件人的名字。

htmlbody():string
返回或設(shè)置郵件正文的html部分。

isoencodeheaders():boolean
郵件頭是否使用iso-8859-1編碼。（默認(rèn)為true）

log():string
當(dāng)logging為true時(shí)，該函數(shù)返回創(chuàng)建的日志。

logging():boolean
是否啟用日志。message.logging=true時(shí)，啟用日志。

maildata():string
返回郵件的源代碼。

maildomain():string
設(shè)置發(fā)送郵件時(shí)使用的郵件服務(wù)器。

mailserverpassword():string
當(dāng)郵件服務(wù)器使用smtp發(fā)信認(rèn)證時(shí)，該函數(shù)設(shè)置登錄密碼。

mailserverusername():string
當(dāng)郵件服務(wù)器使用smtp發(fā)信認(rèn)證時(shí)，該函數(shù)設(shè)置登錄帳號(hào)。

mimeversion():string
聲明mime版本，默認(rèn)為1.0。

mspickupdirectory():string
指定ms smtp服務(wù)的pickup文件夾的位置。

pgpencrypt():boolean
當(dāng)郵件是使用pgp發(fā)送時(shí)并該屬性被設(shè)置為true時(shí)，該郵件將被自動(dòng)加密。

pgpsign():boolean
當(dāng)郵件是使用pgp發(fā)送時(shí)并該屬性被設(shè)置為true時(shí)，該郵件將被自動(dòng)簽名。

priority():byte
設(shè)置郵件的優(yōu)先級(jí)：1、2和3

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

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

replyto():string
指定一個(gè)回復(fù)地址。

silent():boolean
當(dāng)設(shè)置為true時(shí)，send()方法就會(huì)忽略錯(cuò)誤并不將錯(cuò)誤信息返回給操作系統(tǒng)。

simplelayout():boolean
當(dāng)設(shè)置為true時(shí)，發(fā)信時(shí)jmail不會(huì)添加郵件頭到郵件里。

size():integer
返回郵件的總字節(jié)數(shù)。

subject():string
設(shè)置郵件標(biāo)題。

text():string
返回完整的郵件內(nèi)容。

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




4、 headers對(duì)象

屬性（或方法）
描述

getheader(headername):string
返回指定的郵件頭的值。

text():string
返回所有的郵件頭的值。




5、 recipients對(duì)象

屬性（或方法）
描述

add(value)
追加一個(gè)收件人到集合中。

clear()
清除集合中的全部記錄。

count():integer
返回集合中收件人的總數(shù)。

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




6、 recipient對(duì)象

屬性（或方法）
描述

new(name,email,recipienttype):pointer
創(chuàng)建一個(gè)可以添加到收件人集合中recipients的收件人。

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

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

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




7、 attachments對(duì)象

屬性（或方法）
描述

add(attachment)
添加一個(gè)附件到集合。

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

count():integer
返回集合中附件的總數(shù)。

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