JMail 是經典的 ASP/ASP.NET 郵件發送組件,雖然現代開發更推薦 System.Net.Mail 或 MailKit,但維護舊專案時仍需了解 JMail 用法。本文詳解配置、發送流程、附件處理與常見問題。
| 屬性/方法 | 說明 |
|---|---|
| Logging | 啟用日誌記錄,便於除錯 |
| Silent | true:不拋出異常,發送結果透過返回值判斷 |
| MailServerUserName | SMTP 登入用戶名(完整郵箱地址) |
| MailServerPassWord | SMTP 登入密碼(或應用專用密碼) |
| From | 寄件人地址 |
| Subject | 郵件主題 |
| Body | 郵件正文(純文本) |
| HTMLBody | 郵件正文(HTML 格式) |
| AddAttachment(path, inline, displayName) | 添加附件,inline=true 內嵌圖片 |
| AddRecipient(email, name, type) | 添加收件人,type: TO/CC/BCC |
| Send(smtpServer, ssl) | 發送郵件,返回 Boolean |
using JMAIL; // 需引用 JMail 組件
public bool SendMailWithJMail()
{
try
{
MessageClass email = new MessageClass();
// 基礎配置
email.Logging = true; // 開啟日誌
email.Silent = true; // 不拋出異常,由返回值判斷
email.MailServerUserName = "sender@163.com";
email.MailServerPassWord = "your_smtp_password"; // 應用專用密碼
email.From = "sender@163.com";
email.Subject = "測試郵件 - " + DateTime.Now.ToString("yyyy-MM-dd HH:mm");
// 正文:支援 HTML
email.HTMLBody = @"
這是一封測試郵件
發送時間:" + DateTime.Now + @"
祝好!
";
// 附件
email.AddAttachment(@"C:\Reports\monthly.pdf", false, "月報.pdf");
email.AddAttachment(@"C:\Images\chart.png", true, "chart.png"); // 內嵌圖片
// 收件人
email.AddRecipient("receiver@example.com", "接收者", "TO");
email.AddRecipient("cc@example.com", "抄送者", "CC");
// 發送:SMTP 伺服器、是否 SSL
bool success = email.Send("smtp.163.com", true); // 163 使用 SSL (465/994)
if (!success)
{
// Silent=true 時,可透過 Log 檔案或 LastError 排查
string error = email.LastError; // 獲取最後錯誤描述
LogError($"JMail 發送失敗: {error}");
}
return success;
}
catch (Exception ex)
{
LogError($"JMail 異常: {ex.Message}");
return false;
}
}
using System.Net;
using System.Net.Mail;
public async Task SendMailModernAsync()
{
try
{
using var message = new MailMessage
{
From = new MailAddress("sender@163.com", "發送者名稱"),
Subject = "現代郵件發送測試",
Body = "HTML 正文
支援非同步發送
",
IsBodyHtml = true,
Priority = MailPriority.Normal
};
message.To.Add("receiver@example.com");
message.CC.Add("cc@example.com");
message.Attachments.Add(new Attachment(@"C:\Reports\monthly.pdf"));
using var client = new SmtpClient("smtp.163.com", 465) // 或 587 (STARTTLS)
{
Credentials = new NetworkCredential("sender@163.com", "your_smtp_password"),
EnableSsl = true,
DeliveryMethod = SmtpDeliveryMethod.Network,
Timeout = 30000
};
await client.SendMailAsync(message);
return true;
}
catch (SmtpException ex)
{
LogError($"SMTP 錯誤: {ex.StatusCode} - {ex.Message}");
return false;
}
catch (Exception ex)
{
LogError($"發送異常: {ex.Message}");
return false;
}
}
// NuGet: MailKit
using MailKit.Net.Smtp;
using MimeKit;
public async Task SendMailWithMailKitAsync()
{
var message = new MimeMessage();
message.From.Add(new MailboxAddress("發送者", "sender@163.com"));
message.To.Add(new MailboxAddress("接收者", "receiver@example.com"));
message.Subject = "MailKit 郵件測試";
var builder = new BodyBuilder
{
HtmlBody = "MailKit HTML 正文
",
TextBody = "純文本備選內容"
};
builder.Attachments.Add(@"C:\Reports\monthly.pdf");
message.Body = builder.ToMessageBody();
using var client = new SmtpClient();
await client.ConnectAsync("smtp.163.com", 465, true); // SSL
await client.AuthenticateAsync("sender@163.com", "your_smtp_password");
await client.SendAsync(message);
await client.DisconnectAsync(true);
return true;
}
JMail 承載了 ASP 時代的記憶,但新專案請毫猶豫選擇 MailKit(跨平台、功能完整、積極維護)或 System.Net.Mail(零依賴、內建)。核心原理始終是:正確的 SMTP 配置 + 安全的認證 + 異步非阻塞發送 + 完善的錯誤處理與日誌記錄。