FluentEmail 项目教程

2026-01-17 09:24:28作者：贡沫苏Truman

1. 项目的目录结构及介绍

FluentEmail 项目的目录结构如下：

FluentEmail/
├── src/
│   ├── FluentEmail.Core/
│   ├── FluentEmail.MailKit/
│   ├── FluentEmail.Razor/
│   ├── FluentEmail.SendGrid/
│   ├── FluentEmail.Smtp/
│   └── FluentEmail.Mailgun/
├── test/
│   ├── FluentEmail.Core.Tests/
│   ├── FluentEmail.MailKit.Tests/
│   ├── FluentEmail.Razor.Tests/
│   ├── FluentEmail.SendGrid.Tests/
│   ├── FluentEmail.Smtp.Tests/
│   └── FluentEmail.Mailgun.Tests/
├── .gitignore
├── .editorconfig
├── .gitattributes
├── FluentEmail.sln
├── LICENSE
├── README.md
└── CONTRIBUTING.md

目录结构介绍

src/：包含项目的所有源代码。
- FluentEmail.Core/：核心库，包含基础的模型定义和默认设置。
- FluentEmail.MailKit/：使用 MailKit 发送邮件。
- FluentEmail.Razor/：使用 Razor 模板生成邮件内容。
- FluentEmail.SendGrid/：使用 SendGrid API 发送邮件。
- FluentEmail.Smtp/：使用 SMTP 服务器发送邮件。
- FluentEmail.Mailgun/：使用 Mailgun 的 REST API 发送邮件。
test/：包含项目的所有测试代码。
.gitignore：Git 忽略文件配置。
.editorconfig：编辑器配置文件。
.gitattributes：Git 属性配置。
FluentEmail.sln：Visual Studio 解决方案文件。
LICENSE：项目许可证。
README.md：项目说明文档。
CONTRIBUTING.md：贡献指南。

2. 项目的启动文件介绍

FluentEmail 项目的启动文件主要位于各个子项目的 Program.cs 或 Startup.cs 文件中。以下是 FluentEmail.Core 项目的启动文件示例：

using FluentEmail.Core;
using FluentEmail.Smtp;
using System.Net.Mail;
using System.Threading.Tasks;

namespace FluentEmail.Sample
{
    class Program
    {
        static async Task Main(string[] args)
        {
            var sender = new SmtpSender(() => new SmtpClient("localhost")
            {
                EnableSsl = false,
                DeliveryMethod = SmtpDeliveryMethod.Network,
                UseDefaultCredentials = false,
                Credentials = new System.Net.NetworkCredential("username", "password")
            });

            Email.DefaultSender = sender;

            var email = Email
                .From("sender@example.com")
                .To("receiver@example.com")
                .Subject("测试邮件")
                .Body("这是一封测试邮件。");

            await email.SendAsync();
        }
    }
}

启动文件介绍

Program.cs：包含程序的入口点，定义了如何发送邮件。
SmtpSender：配置 SMTP 发送器。
Email.DefaultSender：设置默认的发送器。
Email：构建和发送邮件。

3. 项目的配置文件介绍

FluentEmail 项目的配置文件主要涉及 SMTP 和其他邮件服务的配置。以下是一个典型的配置文件示例：

{
  "SmtpSettings": {
    "Host": "smtp.example.com",
    "Port": 587,
    "Username": "your_username",
    "Password": "your_password",
    "EnableSsl": true
  },
  "SendGridSettings": {
    "ApiKey": "your_sendgrid_api_key"
  },
  "MailgunSettings": {
    "ApiKey": "your_mailgun_api_key",
    "Domain": "your_mailgun_domain"
  }
}