jmail的属性和方法

jmail的属性和方法

body : string (v3.0)

e-mail的主体

jmail.body = "hello world"

charset : string (v3.0)

设定邮件的字符集，默认为"us-ascii"

jmail.charset = "us-ascii"

contenttransferencoding : string (v3.0)

指定内容编码， 默认为 "quoted-printable"

jmail.contenttransferencoding = "base64"

contenttype : string (v3.0)

这个邮件的头设置， 默认为 "text/plain" 能设

置成你需要的任何情况。 你想发送html信息,改这个头文件为 "text/html" jmail.contenttype = "text/html"

deferreddelivery : date (v3.0)

设置时间。 如果mailserver服务器支持，可以设置何时发送邮件。

jmail.deferreddelivery = new date( 2000, 02, 17 ).getvardate(); encoding : string (v3.0)

this can be used to change the default attachment encoding from base64. valid options are

- 1 -

"base64", "uuencode" or "quoted-printable"

jmail.encoding = "base64"

errorcode : integer (v3.0)

报错误信息，如果jmail.silent被设置成true

response.write( jmail.errorcode )

errormessage : string (v3.0)

报错误信息，如果jmail.silent被设置成true

response.write( jmail.errormessage )

errorsource : string (v3.0)

报错误信息，如果jmail.silent被设置成true

response.write( jmail.errorsource )

isoencodeheaders : boolean (v3.0)

头信息代码按照iso-8859-1字符设置。 the default is true. jmail.isoencodeheaders = false

lazysend : boolean (v3.0)

这个属性是将邮件放入缓冲直至发出为止，的不到任何的错误信息

zysend = true;

log : string (v3.0)

当loging被设置后，这个log被jmail生成

response.write( jmail.log )

logging : boolean (v3.0)

- 2 -

能/不能登陆用jmail

jmail.logging = true

maildomain : string (v3.0)

可以忽略 ehlo/helo 状态对你的mailserver

jmail.maildomain = ""

mimeversion : string (v3.0)

专门的 mime 版本. the default is "1.0"

jmail.mimeversion = "1.0"

priority : integer (v3.0)

邮件的优先级，可以范围从1到5。

越大的优先级约高，比如，5最高，1最低

一般设置为3

jmail.priority = 3

recipients : string (v3.0)

这个信息的接收者只有只读属性

response.write( "" + jmail.recipients + "" )

replyto : string (v3.0)

指定一个可选的回信地址

jmail.replyto = "president@"

returnreceipt : boolean (v3.0)

是否按寄件人的要求回信，默认是"false"

jmail.returnreceipt = true

- 3 -

sender : string (v3.0)

邮寄的地址

jmail.sender = "batman@"

sendername : string (v3.0)

收信人姓名

jmail.sendername = "bat man"

serveraddress : string (v3.0)

server的地址。可以有很多的server地址，后可跟端口号 jmail.serveraddress = "; :2500" silent : boolean (v3.0)

设置成true后jmail将检查所有的邮件在 jmail.execute() 执行后

返回真或假根据信件发送的成功与否depending on the success of the operation

jmail.silent = true

simplelayout : boolean (v3.0)

设置成true减少jmail产品头数量

jmail.simplelayout = true

subject : string (v3.0)

邮件的标题。

jmail.subject = "dimac rocks big time!"

usepipelining : boolean (v3.0)

- 4 -

管道的支持。

jmail.pipelining = false

jmail的方法

addattachment( filename, [contenttype] ) (v3.0)

加入一个附件

jmail.addattachment( "c:\\autoexec.bat" );

addheader( xheader, value ) (v3.0)

加入一个头信息

jmail.addheader( "originating-ip","193.15.14.623" );

addnativeheader( header, value ) (v3.0)

加入一个头信息

jmail.addnativeheader( "mta-settings", "route" );

addrecipient( email ) (v3.0)

加入一个收件者

jmail.addrecipient( "info@" );

addrecipientbcc( email ) (v3.0)

屏蔽某个接受者。不给其发送邮件

jmail.addrecipientbcc( "someone@" );

addrecipientcc( email ) (v3.0)

抄写一份给另一接受者

jmail.addrecipientcc( "someone@" );

addrecipientex( email, name ) (v3.0)

- 5 -

加入和邮件相对应的名称

jmail.addrecipientex( "info@", "dimac info" );

appendbodyfromfile( filename ) (v3.0)

将文件的内容发送出去

jmail.appendbodyfromfile( "c:\\mytext.txt" );

appendtext( text ) (v3.0)

添加附件

jmail.appendtext( "text appended to message body" );

clearattachments() (v3.0)

清除附件列表

jmail.clearattachments();

clearcustomheaders() (v3.0)

清空所有的用户头信息

jmail.clearcustomheaders(); clearrecipients() (v3.0)

清空收件箱

jmail.clearrecipients();

close() (v3.0)

强行制止邮件的发送

jmail.close();

execute() : boolean (v3.0)

执行邮件发送到server

- 6 -

jmail.execute();

extractemailaddressesfromurl( bstrurl, [bstrauth] ) (v3.0)

从url或下载加入邮件地址

jmail.extractemailaddressesfromurl( "/generateemaillist.asp" );

logcustommessage( message ) (v3.0)

登陆用户信息到jmail的log，这个功能只有将loging设置为true时可以用

jmail.logcustommessage( "hello world" );

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对象操作

- 7 -

的；

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() 从邮件服务器上删除所有邮件。

- 8 -

DeleteSingleMessage(MessageID) 从邮件服务器上删除由MessageID指定的邮件。

Disconnect() 关闭跟邮件服务器的连接。

DownloadHeaders() 从邮件服务器上读取所有的邮件头并传递给Messages集合。

DownloadMessages() 从邮件服务器读取所有邮件。

DownloadSingleHeader(MessageID) 从邮件服务器读取指定的邮件头并传递给Messages集合。

DownloadUnreadMessages() 从邮件服务器上读取所有未读邮件。

2、.Messages对象

属性（或方法） 说明

Clear() 清除集合中的所有内容，并不会删除邮件服务器上的任何邮件。

Count():Integer 返回集合中记录的数目：I=Messages.Count Item(Index):Pointer

3、.Message对象

属性（或方法） 说明

AddAttachment(FileName,isInline,ContentType):String 给邮件添加一个文件型的附件。isInline设置为True时，添加的这个附件就是一个可嵌入的附件。

- 9 -

返回一个Message对象。Set oMsg=Messages.Item(0)

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

- 10 -

清除附件列表。如：

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 发送邮件。邮件服务器是一个描述邮件服务器名称或地址的字符串，用户名和密码是可选项。当要发送认证邮件时使用格式为：用户名:密码@邮件服务器

- 11 -

SendToNewsGroup(ServerName,NewsGroup) 使用指定的ＮＮＴＰ服务器发送邮件到新闻组，多个邮件用“,”隔开。

About():string 设置一些附加信息。

Attachments():Pointer 返回邮件的附件集合。Set Attachments=Message.Attachments

Body():String

BodyText():String 返回邮件正文。Response.Write (Message.Body) 返回全部的文本正文。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时，该函数包含错误号。

- 12 -

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发送时并该属性被

- 13 -

设置为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) 追加一个收件人到集合中。

- 14 -

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 返回集合中指定的附件。

8、 Attachment对象

属性（或方法） 描述

New(FileName,ContentType,Data):Pointer 创建一个可以加入到Attachments集合的附件。如果指定Data的值，那么Jmail将创建一个以Data参数为内容的自定义附件。

- 15 -

SaveToFile(FileName) 保存附件到硬盘。

ContentType():String 返回附件类型（ContentType） Data():String 返回附件的内容。

BinaryData():String 以二进制模式返回附件的内容。

IsInline():Boolean 如果附件被设置为可嵌入（inline）,则返回True。

Name():String 返回附件的文件名称。

Size():Integer 返回附件的大小。

9、 MailMerge对象

属性（或方法） 描述

BulkMerge(RecordSet,enque,Maildestination) 参照邮件模板合并所有记录，要指定使用的pickuo文件夹或邮件服务器。

Expand():Pointer 参照用户指定的方式合并邮件模板（mailTemplate）。

ExpandFromRecordSet(RecordSet):Pointer 参照邮件模板（mailTemplate）合并ADO对象中的一例。

SetDebugMode(TestMailAddress,TestCount) 将邮件合并（mailMerge）设置为测试模式。

Item(VariableNmae):String 手工设置合并参数。注意：该功能不使用于ADO数据例的合并。

MailTemplate():Pointer 设置一个创建好的Message对象，这个对象将被作为邮件合并的模板。

- 16 -

MergeAttachments():Boolean 当该属性设置为 True时，附件被作为邮件合并的一个选项。

10、 PGPKeys对象

属性（或方法） 描述

Count():Integer 返回密码的总数。

Item(Index):Pointer 返回PGPKey信息对象。

11、 PGPKeyInfo对象

属性（或方法） 描述

KeyCreateDate():String 返回邮件密码创建的时间。 KeyID():String 返回密码的ID号。

KeyUser():String 返回创建密码的用户名。

12、 SpeedMailer对象

属性（或方法） 描述

EnqueMail(FromEmail,RecipientEmails,

Subject,Body,MsPickupdirectory) 添加一个邮件到发送队列。内容、主题等数据通过该方法的参数传递。

SendMail(FromEMail,RecipientEMails,

Subject,Body,MailServers) 通过SMTP发送一封邮件。内容、主题等数据通过该方法的参数传递。

SendXMLMail(XML) 关于该函数的用法请访问：/namespace/jmail

- 17 -

本文来源：https://www.bwwdw.com/article/05wj.html