### Jmail 使用详解
#### 一、概述
Jmail 是一款功能强大的邮件组件，它可以方便地集成到多种编程环境中，例如 VB、JavaScript 和 C# 等，用于发送和接收电子邮件。一旦安装并注册了 Jmail.dll 文件后，开发者便可以通过调用 `JMail.Message` 对象来实现邮件的发送功能。
#### 二、关键属性与方法介绍
##### 1. Body
- **定义**：此属性代表邮件正文内容。
- **类型**：String
- **版本**：v3.0
- **用途**：设置或获取邮件正文内容。
- **示例**：
- 在 VBScript 中，设置邮件正文：`JMail.Body = "Hello world!"`
- 在 JavaScript 中，设置邮件正文：`JMail.Body = 'Hello world!';`
##### 2. Charset
- **定义**：指定邮件使用的字符集。
- **类型**：String
- **版本**：v3.0
- **默认值**：US-ASCII
- **用途**：设置邮件的字符集，以确保邮件内容能被正确解析。
- **示例**：
- 设置邮件字符集为 UTF-8：`JMail.Charset = 'UTF-8';`
##### 3. ContentTransferEncoding
- **定义**：指定邮件内容传输时的编码方式。
- **类型**：String
- **版本**：v3.0
- **默认值**：Quoted-Printable
- **用途**：控制邮件内容在传输过程中的编码方式，以适应不同网络环境的需求。
- **示例**：
- 将邮件内容的编码方式设置为 Base64：`JMail.ContentTransferEncoding = 'base64';`
##### 4. ContentType
- **定义**：指定邮件的 MIME 类型。
- **类型**：String
- **版本**：v3.0
- **默认值**：text/plain
- **用途**：设置邮件内容类型，如纯文本或 HTML 格式。
- **示例**：
- 设置邮件内容类型为 HTML：`JMail.ContentType = 'text/html';`
##### 5. DeferredDelivery
- **定义**：允许设置邮件的延迟发送时间。
- **类型**：Date
- **版本**：v3.0
- **用途**：如果邮件服务器支持该特性，则可以在未来某个指定的时间发送邮件。
- **示例**：
- 设置邮件在特定日期时间发送：`(JavaScript) JMail.DeferredDelivery = new Date(2000, 02, 17).getVarDate();`
##### 6. Encoding
- **定义**：指定附件的编码方式。
- **类型**：String
- **版本**：v3.0
- **默认值**：base64
- **用途**：控制附件的编码方式，以便于在网络上传输。
- **示例**：
- 将附件编码方式设置为 uuencode：`JMail.Encoding = 'uuencode';`
##### 7. ErrorCode
- **定义**：当 JMail.silent 设置为 true 时，此属性包含错误代码。
- **类型**：Integer
- **版本**：v3.0
- **用途**：在静默模式下，用于捕获发送过程中出现的错误代码。
- **示例**：
- 获取错误代码：`Response.Write(JMail.ErrorCode);`
##### 8. ErrorMessage
- **定义**：当 JMail.silent 设置为 true 时，此属性包含错误信息。
- **类型**：String
- **版本**：v3.0
- **用途**：在静默模式下，用于捕获发送过程中出现的错误信息。
- **示例**：
- 获取错误信息：`Response.Write(JMail.ErrorMessage);`
##### 9. ErrorSource
- **定义**：当 JMail.silent 设置为 true 时，此属性包含错误来源。
- **类型**：String
- **版本**：v3.0
- **用途**：在静默模式下，用于确定错误发生的源头。
- **示例**：
- 获取错误来源：`Response.Write(JMail.ErrorSource);`
##### 10. ISOEncodeHeaders
- **定义**：指定是否将邮件头部编码为 ISO-8859-1 字符集。
- **类型**：Boolean
- **版本**：v3.0
- **默认值**：true
- **用途**：控制邮件头部的编码方式。
- **示例**：
- 关闭邮件头部的 ISO 编码：`JMail.ISOEncodeHeaders = false;`
##### 11. LazySend
- **定义**：指定 Jmail 是否立即发送邮件，还是在后台缓冲并异步发送。
- **类型**：Boolean
- **版本**：v3.0
- **用途**：控制邮件发送的方式。
- **示例**：
- 设置为后台异步发送：`JMail.LazySend = true;`
- **注意事项**：选择此选项后，无法捕获错误信息，且 ServerAddress 属性将失效。
##### 12. Log
- **定义**：Jmail 创建的日志内容。
- **类型**：String
- **版本**：v3.0
- **用途**：记录邮件发送过程中的详细信息。
- **示例**：
- 输出日志信息：`Response.Write(JMail.Log);`
##### 13. Logging
- **定义**：指定是否启用日志记录功能。
- **类型**：Boolean
- **版本**：v3.0
- **用途**：控制是否记录邮件发送过程中的日志信息。
- **示例**：
- 启用日志记录：`JMail.Logging = true;`
##### 14. MailDomain
- **定义**：用于覆盖发送邮件时向邮件服务器声明的域名。
- **类型**：String
- **版本**：v3.0
- **用途**：自定义 EHLO/HELO 命令中使用的域名。
- **示例**：
- 设置自定义域名：`JMail.Maildomain = 'hello.world.com';`
##### 15. MimeVersion
- **定义**：指定邮件的 MIME 版本。
- **类型**：String
- **版本**：v3.0
- **默认值**：1.0
- **用途**：设置邮件 MIME 版本。
- **示例**：
- 设置 MIME 版本为 1.1：`JMail.MimeVersion = '1.1';`
##### 16. Priority
- **定义**：设置邮件的优先级。
- **类型**：Integer
- **版本**：v3.0
- **范围**：1-5 (1 表示最高优先级，5 表示最低优先级)
- **用途**：控制邮件的优先级别。
- **示例**：
- 设置邮件优先级为最高：`JMail.Priority = 1;`
##### 17. Recipients
- **定义**：只读属性，返回所有收件人的列表。
- **类型**：String
- **版本**：v3.0
- **用途**：获取所有收件人的信息。
- **示例**：
- 显示所有收件人：`Response.Write('收件人列表：' + JMail.Recipients + '');`
##### 18. ReplyTo
- **定义**：指定一个可选的回信地址。
- **类型**：String
- **版本**：v3.0
- **用途**：设置邮件的回信地址。
- **示例**：
- 设置回信地址：`JMail.ReplyTo = 'president@dimac.net';`
##### 19. ReturnReceipt
- **定义**：指定是否需要发送回复收据。
- **类型**：Boolean
- **版本**：v3.0
- **默认值**：false
- **用途**：要求邮件接收方确认已收到邮件。
- **示例**：
- 请求发送回执：`JMail.ReturnReceipt = true;`
##### 20. Sender
- **定义**：指定发件人的邮件地址。
- **类型**：String
- **版本**：v3.0
- **用途**：设置邮件的发件人地址。
- **示例**：
- 设置发件人地址：`JMail.Sender = 'batman@dimac.net';`
##### 21. SenderName
- **定义**：指定发件人的姓名。
- **类型**：String
- **版本**：v3.0
- **用途**：设置发件人的姓名。
- **示例**：
- 设置发件人姓名：`JMail.SenderName = 'Batman';`
##### 22. ServerAddress
- **定义**：指定邮件服务器的地址。
- **类型**：String
- **版本**：v3.0
- **用途**：设置邮件服务器地址。
- **示例**：
- 设置邮件服务器地址：`JMail.ServerAddress = 'smtp.example.com';`
#### 三、总结
通过上述详细介绍，我们可以看到 Jmail 提供了丰富的配置选项和功能，使得开发者能够根据实际需求灵活地配置邮件发送的各项参数。无论是从简单的纯文本邮件到复杂的 HTML 格式邮件，还是从即时发送到延迟发送，Jmail 都能提供相应的支持。对于需要频繁处理邮件发送任务的应用程序来说，掌握这些配置项的使用方法是非常重要的。
