在日常开发或自动化任务中,发送电子邮件仍然是最常用的数据传递方式之一。通过代码发送邮件,不仅可以提高效率,还能实现批量通知、报表推送等功能。本文将介绍如何使用 C# 发送包含普通文本、HTML 正文以及附件的电子邮件,并提供完整的示例代码。
本文使用 Free Spire.Email for .NET,可通过 NuGet 安装:
Install-Package FreeSpire.Email
Spire.Email 提供 MailAddress
和 MailMessage
类来构建邮件内容。你可以轻松添加多个收件人、抄送(Cc)、密送(Bcc)对象,并指定邮件的文本和 HTML 内容。
代码示例:
using Spire.Email;
using Spire.Email.Smtp;
// 创建发件人和收件人地址
MailAddress from = new MailAddress("[email protected]", "你的名字");
MailAddress to1 = new MailAddress("[email protected]", "用户1");
MailAddress to2 = new MailAddress("[email protected]", "用户2");
// 创建邮件消息对象
MailMessage message = new MailMessage(from, to1);
message.To.Add(to2); // 添加第二个收件人
message.Cc.Add(new MailAddress("[email protected]", "抄送人"));
message.Bcc.Add(new MailAddress("[email protected]")); // 添加密送人
// 设置邮件主题、HTML 正文和纯文本正文
message.Subject = "月次报告 - 2025年6月";
message.BodyHtml = "报告概要
请查收附件中的 PDF 报告。
";
message.BodyText = "报告概要 - 请查收附件中的 PDF。";
该示例同时设置了文本正文和 HTML 正文,客户端将根据支持情况优先显示 HTML 内容。
邮件附件可通过 Attachment
类添加,例如 PDF 报表、Excel 文件等。
代码示例:
// 添加附件
Attachment attachment = new Attachment(@"Sample.pdf");
message.Attachments.Add(attachment);
只需提供文件路径,即可将其添加为邮件附件。
SMTP(简单邮件传输协议)用于将邮件从客户端发送到服务器。Spire.Email 提供 SmtpClient
类来连接并发送邮件。
代码示例:
// 配置 SMTP 客户端
SmtpClient smtp = new SmtpClient();
smtp.Host = "smtp.gmail.com"; // SMTP 服务器地址
smtp.Port = 587; // TLS 使用的端口号
smtp.Username = "[email protected]"; // 邮箱用户名
smtp.Password = "your_password"; // 应用专用密码
smtp.ConnectionProtocols = ConnectionProtocols.StartTls; // 使用 TLS 加密协议
// 发送邮件
smtp.SendOne(message);
注意:Gmail 发送邮件需要启用“应用专用密码”,并确保启用了 SMTP 服务。
以下是完整的邮件发送代码,整合了所有功能:
using Spire.Email;
using Spire.Email.Smtp;
// 创建发件人和收件人
MailAddress from = new MailAddress("[email protected]", "你的名字");
MailAddress to1 = new MailAddress("[email protected]", "用户1");
MailAddress to2 = new MailAddress("[email protected]", "用户2");
// 创建邮件对象
MailMessage message = new MailMessage(from, to1);
message.To.Add(to2);
message.Cc.Add(new MailAddress("[email protected]", "抄送人"));
message.Bcc.Add(new MailAddress("[email protected]", "密送人"));
// 设置主题和正文
message.Subject = "月次报告 - 2025年6月";
message.BodyHtml = "报告概要
请查收附件中的 PDF 报告。
";
message.BodyText = "报告概要 - 请查收附件中的 PDF 文件。";
// 添加附件
Attachment attachment = new Attachment(@"G:\Documents\Sample.pdf");
message.Attachments.Add(attachment);
// 配置 SMTP 客户端并发送邮件
SmtpClient smtp = new SmtpClient();
smtp.Host = "smtp.gmail.com";
smtp.Port = 587;
smtp.Username = "[email protected]";
smtp.Password = "your_app_password";
smtp.ConnectionProtocols = ConnectionProtocols.StartTls;
smtp.SendOne(message);
邮件发送结果:
通过 Free Spire.Email for .NET,C# 开发者可以轻松实现功能丰富的邮件发送任务,包括:
这些功能适用于自动化报告推送、系统告警通知、用户邮件服务等多种场景。
更多功能请参考:Spire.Email for .NET 教程中心。