Postal - ASP.NET MVC 邮件发送库使用详解

1. 安装指南

Postal 是一个基于 ASP.NET MVC 的邮件发送库，利用 MVC 视图引擎来渲染邮件内容。以下是安装 Postal 的步骤：

1. 打开您的 ASP.NET MVC 项目。
2. 在 NuGet 包管理器中搜索并安装 Postal.MVC5 包（或对应版本的包）。
3. 安装完成后，Postal 库将被添加到项目中。

2. 项目的使用说明

Postal 允许您通过定义视图来创建和发送电子邮件。以下是基本的使用步骤：

创建邮件视图

1. 在项目中创建一个名为 Emails 的文件夹，该文件夹位于 Views 文件夹下。
2. 在 Emails 文件夹中，添加您的邮件视图文件，例如 Example.cshtml。

To: @ViewBag.To
From: [e-mail]
Subject: Important Message

Hello,
You wanted important web links right? Check out this: @ViewBag.FunnyLink <3

发送邮件

在控制器中，使用 Email 类来创建和发送邮件：

public class HomeController : Controller
{
    public ActionResult Index()
    {
        dynamic email = new Email("Example")
        {
            To = "[e-mail]",
            FunnyLink = DB.GetRandomLolcatLink()
        };
        email.Send();
        return View();
    }
}

强类型邮件

如果您希望使用强类型数据来创建邮件，可以定义一个继承自 Email 类的强类型类：

public class TypedEmail : Email
{
    public string To { get; set; }
    public string FunnyLink { get; set; }
    
    public TypedEmail(string viewName) : base(viewName)
    {
    }
}

然后，在控制器中使用该类：

public class HomeController : Controller
{
    public ActionResult Index()
    {
        var email = new TypedEmail("Example")
        {
            To = "[e-mail]",
            FunnyLink = DB.GetRandomLolcatLink()
        };
        email.Send();
        return View();
    }
}

3. 项目API使用文档

Postal 提供了以下 API 来帮助您发送和管理邮件：

• Email 类：用于创建和发送邮件。
• EmailService 类：提供了更大的控制，并且更易于单元测试和模拟。

Email 类

• Email(string viewName)：构造函数，接受一个视图名称。
• To：收件人地址。
• From：发件人地址。
• Subject：邮件主题。
• Send()：发送邮件。

EmailService 类

• EmailService()：构造函数。
• SendEmail(Email email)：发送邮件。

4. 项目安装方式

如前所述，Postal 可以通过 NuGet 包管理器进行安装。以下是具体的安装步骤：

1. 打开 Visual Studio。
2. 在解决方案资源管理器中，右键点击您的项目。
3. 选择“管理 NuGet 包”。
4. 在 NuGet 包管理器中搜索 Postal.MVC5。
5. 选择并安装 Postal.MVC5 包。

安装完成后，您可以开始在项目中使用 Postal 库来发送邮件。