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