jmail的属性和方法

更新时间:2023-08-16 12:07:01 阅读量: 教学研究 文档下载

说明:文章内容仅供预览,部分内容可能不全。下载后的文档,内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的,是否完整无缺。

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) 使用指定的NNTP服务器发送邮件到新闻组,多个邮件用“,”隔开。

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

Top