ASP.NET Web Pages - WebMail 物件完整參考與 SMTP 設定實戰

WebMail 物件封裝 SMTP 協定，提供簡潔 API 讓 Web Pages 輕鬆發送電子郵件，支援 SSL、附件、HTML 郵件、抄送等企業級功能。

WebMail 物件核心屬性

Send() 方法完整參數說明

技術規格

WebMail 初始化最佳實務：_AppStart.cshtml

在網站根目錄建立 _AppStart.cshtml (若不存在)，應用程式啟動時自動執行：

@{
 WebMail.SmtpServer = "smtp.example.com";
 WebMail.SmtpPort = 587;              // TLS 標準埠
 WebMail.EnableSsl = true;            // 強制加密
 WebMail.UserName = "noreply@example.com";
 WebMail.Password = "your-app-password"; // 使用應用程式專用密碼
 WebMail.From = "noreply@example.com";
}

關鍵設定說明：

• SmtpServer：郵件服務商提供 (Gmail: smtp.gmail.com, Outlook: smtp.office365.com, SendGrid: smtp.sendgrid.net)
• Port 587 + EnableSsl=true：現代標準 TLS 加密模式 (STARTTLS)
• Port 465 + EnableSsl=true**：舊式 SSL 隱含加密模式
• Password**：Gmail/Outlook 需啟用「應用程式密碼」而非登入密碼
• From**：需通過 SPF/DKIM/DMARC 驗證的網域郵箱，提高送達率

注意： _AppStart 中初始化屬性後，呼叫 WebMail.Send() 前無需重複設定，除非需動態覆蓋特定郵件參數。

常見 SMTP 服務商設定速查

進階用法：非同步發送與錯誤處理

@functions {
 public static async Task<bool> SendAsync(string to, string subject, string body, bool isHtml = true) {
 try {
 WebMail.Send(to: to, subject: subject, body: body, isBodyHtml: isHtml);
 return true;
 } catch (Exception ex) {
 // 記錄日誌: Log.Error(ex, "Email send failed to {To}", to);
 return false;
 }
 }
}

生產環境建議：使用背景工作服務 (Hangfire、Quartz、IHostedService) 佇列發送，避免封鎖 HTTP 要求執行緒；整合 Serilog/NLog 記錄發送狀態；實作重試機制與死信佇列。