5. MIME 標頭建構（支援 Base64 主旨、HTML/純文字、字集、優先權）

string BuildMailHeaders()
{
    string h = "";
    h += "From: " + FromName + "<" + From + ">" + crlf;
    h += "To: " + RecipientName + "<" + Recipient[0] + ">" + crlf;
    h += "CC: " + string.Join(",", Recipient.Skip(1).Select((r,i)=>RecipientName[i]+"<"+r+">")) + crlf;
    if (!string.IsNullOrEmpty(ReplyTo)) h += "Reply-To: " + ReplyTo + crlf;
    h += "Subject: " + (string.IsNullOrEmpty(Charset) ? Subject : "=?"+Charset.ToUpper()+"?B?"+Base64Encode(Subject)+"?=") + crlf;
    h += "MIME-Version: 1.0" + crlf;
    h += "Content-Type: " + (Html ? "text/html" : "text/plain") + "; charset=" + (string.IsNullOrEmpty(Charset)?"iso-8859-1":Charset.ToLower()) + crlf;
    h += "Content-Transfer-Encoding: base64" + crlf;
    h += "X-Priority: " + priority + crlf;
    return h;
}

公開介面：多載 Send 方法

// 僅用屬性設定
public bool Send() { /* 驗證屬性 → SendEmail() */ }

// 指定 SMTP 伺服器字串 "user:pass@host:port"
public bool Send(string smtpserver) { MailDomain=smtpserver; return Send(); }

// 完整參數單次發送
public bool Send(string smtpserver, string from, string fromname, string replyto,
                 string to, string toname, bool html, string subject, string body)
{
    MailDomain=smtpserver; From=from; FromName=fromname; ReplyTo=replyto;
    AddRecipient(to); RecipientName=toname; Html=html; Subject=subject; Body=body;
    return Send();
}

Base64 編碼輔助方法

private string Base64Encode(string src)
{
    return Convert.ToBase64String(Encoding.GetEncoding(Charset).GetBytes(src));
}

使用範例

var mail = new SmtpMailComponent
{
    MailDomain = "smtp.gmail.com:587", // 或 "user:pass@smtp.gmail.com:587"
    From = "me@gmail.com",
    FromName = "My App",
    Subject = "測試郵件",
    Body = "
Hello
這是 HTML 郵件
",
    Html = true,
    Charset = "utf-8",
    Priority = "3"
};
mail.AddRecipient("you@example.com", "收件人");
bool ok = mail.Send();
if (!ok) Console.WriteLine(mail.ErrorMessage);

注意事項與現代化建議

• 安全性：原始碼使用明文傳輸（埠 25），生產環境**必須**升級支援 STARTTLS 或隱性 SSL（埠 465），可搭配 SslStream 實作。
• 編碼：主旨與本文皆以 Base64 編碼，相容中文等非 ASCII 字元。
• 替代方案：.NET 2.0+ 建議直接使用 System.Net.Mail.MailMessage + SmtpClient（支援 SSL、非同步、附件、替代檢視），僅在教學、舊系統維護或特殊協議需求時參考本實作。
• 例外處理：網路操作應包裝於 try/catch/finally 確保 TcpClient/NetworkStream 正確釋放。

總結

本元件完整展示了 SMTP/ESMTP 協議的指令交互流程、驗證機制、MIME 郵件結構建構與 Base64 編碼應用。透過逐行解析核心原始碼，讀者可深入理解郵件發送底層機制，並具備擴充支援附件、多部份 MIME、DKIM 簽名等進階功能的基礎。