C# 基于 System.Net.Mail 的通用 SMTP 邮件发送类封装

mail 发送原理与准备工作

C# 发送邮件主要依赖 System.Net.Mail 命名空间。核心组件包括：
1. MailMessage：用于构建邮件内容，包含发件人、收件人、主题、正文及附件。
2. SmtpClient：负责连接到邮件服务器（SMTP），处理网络传输与认证。

在使用前，请确保目标邮箱服务（如 QQ 邮箱、企业邮箱）已开启 POP3/SMTP 服务，并获取对应的授权码或密码，而非登录密码。

创建 MailSmtp 类

为了实现简化的调用体验，我们可以创建一个静态或单例模式的辅助类。该类内部维护 SmtpClient 实例，并提供属性设置方法。

using System;
using System.IO;
using System.Web.UI.WebControls; // 某些环境可能需要
using System.Text;
using System.Net.Mail;
using System.Net;
using System.Linq;
using System.Text.RegularExpressions;

namespace SyntacticSugar
{
  public class MailSmtp
  {
    private SmtpClient _smtp = new SmtpClient();
    private Encoding _encoding { get; set; }
    private bool _isHtml { get; set; }
    private string[] _cc { get; set; }
    private string[] _bcc { get; set; }
    public string Result { get; private set; }

    // 构造函数：初始化基础 SMTP 连接信息
    public MailSmtp(string host, string username, string password)
    {
      this._smtp.Host = host;
      this._smtp.Port = 25; // 默认端口
      this._smtp.EnableSsl = false;
      this._isHtml = true;
      this._encoding = Encoding.UTF8;
      
      if (string.IsNullOrEmpty(username) || string.IsNullOrEmpty(password))
      {
        this._smtp.UseDefaultCredentials = false;
      }
      else
      {
        this._smtp.Credentials = new NetworkCredential(username, password);
      }
    }

    // 其他设置方法省略，见下文操作部分
    // ...
  }
}

配置邮件参数

在调用发送方法前，需要针对具体需求设置编码、格式、安全协议及收件人列表。以下为关键配置步骤：

第1步：设置编码与格式

通过 SetEncoding 指定字符集，默认推荐 UTF-8 以兼容中文；通过 SetIsHtml 决定正文是否解析为 HTML 标签。

// 设置编码为 UTF-8
ms.SetEncoding(System.Text.Encoding.UTF8); 
// 设置正文为 HTML 格式
ms.SetIsHtml(true); 

第2步：配置抄送、暗送与安全通道

支持批量添加 CC（抄送）和 BCC（暗送）。若邮件服务商要求安全连接，需启用 SSL。

// 添加抄送地址（支持多个）
ms.SetCC("user1@example.com", "user2@example.com");
// 添加暗送地址
ms.SetBC("admin@example.com");
// 启用 SSL 加密连接
ms.SetIsSSL(true); 

执行邮件发送

Send 方法是核心入口，它接收发件人、标题、正文及附件路径。方法内部包含严格的邮箱格式正则校验，防止无效请求。

第3步：调用 Send 方法发送带附件邮件

传入必要的字符串参数及附件路径数组。方法返回布尔值表示发送状态，失败时可通过 Result 属性查看错误原因。

MailSmtp ms = new MailSmtp("smtp.qq.com", "your_email@qq.com", "your_auth_code");

// 构造参数：发件人邮箱, 发件人显示名, 主收件人, 主题, 正文, 附件路径
bool isSuccess = ms.Send(
    "your_email@qq.com",      // from
    "管理员",                  // sender
    "target_user@qq.com",     // to
    "测试邮件主题",             // subject
    "这是一封HTML格式的测试邮件", // body
    Server.MapPath("~/Test.dll") // 附件数组(可变参数)
);

// 检查发送结果
if (!isSuccess)
{
    Response.Write("发送失败: " + ms.Result);
}
else
{
    Response.Write("发送成功！");
} 

完成判断与排错

发送完成后，首先检查返回值是否为 true。如果返回 false，通常原因包括：
1. **邮箱格式错误**：正则表达式校验未通过。
2. **网络或认证失败**：SMTP 服务器拒绝连接，通常是密码错误、端口错误或 SSL 设置不匹配。
3. **文件找不到**：附件路径在服务器上不存在。

建议在开发环境中先关闭 SSL 或使用标准端口测试连通性，再在生产环境中启用加密。

总结

通过自定义 MailSmtp 类，我们将复杂的 MailMessage 构建过程隐藏起来，提供了统一的 Send 接口。这种封装方式不仅提高了代码复用率，还通过内置的正则校验增强了系统的健壮性。以上就是 C# MailSmtp 邮件发送类的详细内容，更多关于 CSharp 邮件编程的资料请关注本站其它相关文章！