Azure 上通过 SendGrid 发送邮件

SendGrid 是什么？

SendGrid 是架构在云端的电子邮件服务，它能提供基于事务的可靠的电子邮件传递。

并且具有可扩充性和实时分析的能力。常见的用例有：

• 自动回复用户的邮件
• 定期发送信息给用户
• 生成报表等

由于使用 SendGrid 这样的第三方邮件服务既稳定可靠又不用自己维护邮件服务器，并且对于邮件发送量不大的应用，免费发送的邮件数 (每个月25000封)已经可以满足需求。所以越来越多的应用都开始使用这种邮件服务来发送邮件。

下面我们从 Azure 上创建 SendGrid 账号开始，介绍如何通过 SendGrid 发送邮件。

创建 SendGrid 账号

登录 Azure 的管理网站，点击 "+"开始创建 SendGrid 账号。在搜索栏中输入“SendGrid Email Delivery”并回车：

选择“SendGrid Email Delivery”进入简介界面：

在简介界面中，可以读到一些基本的信息，当然直接点击“Create”就可以了！此时进入创建 SendGrid 详情界面，界面的基本信息我们就不关注了，请直接查看 Pricing tier 中 F1 free 的收费标准，这可是货真价实的每个月25000封免费邮件。最后点击“Create”完成创建：

SendGrid 账号创建完成后，我们查看一下它的 Configurations 信息：

在使用 SendGrid 发送邮件时，需要用到这些信息。首先你会看到用户名已经被处理过了，在访问 SendGrid 服务时，我们使用的就是这个被处理过的用户名称。还有下面的 SMTP SERVER，也就是说当我们创建了 SendGrid 账号后，还可以用传统的方式通过指定的 SMTP 服务器来发送邮件。

在C# 项目中使用 SendGrid

假如我们要在一个 asp.net 的应用中通过 SendGrid 发送邮件。那么在使用 SendGrid 服务之前，我们需要先在该项目中安装 SendGrid 提供的组件。请在 Visual Studio 的 Package Manager Console 中执行下面的命令：

> Install-Package Sendgrid -Version 6.3.

注意，SendGrid 的 API 升级很快，我们这里使用的是 V2 版本的 API，所以要指定安装的版本。

发送测试邮件

万事俱备，让我们先发送一封普通的邮件试试：

// 请使用前面介绍的被 SendGrid 处理过的用户名。

string username = "xxxxx";

string password = "yyyyy";

var credentials = new NetworkCredential(username, password);

var transport = new Web(credentials);

var myMessage = new SendGridMessage();

myMessage.From = new MailAddress("fromaddress");

myMessage.AddTo("toaddress");

myMessage.Subject = "test";

myMessage.Html = "<p>Hello World!</p>";

// 通过异步方法发送邮件。

transport.DeliverAsync(myMessage);

代码很简单。需要注意的是，这段代码在你本地调试时，是无法发送邮件的。你需要把你的应用发布到 Azure 的 Web App 或是 Cloud Service 上才能成功发送邮件。

发送带附件的邮件

你可以使用 SendGridMessage.AddAttachment 方法，为你的邮件添加附件。这个方法有两个重载，分别是指定文件路径和文件流。如果你的程序运行在 Azure上，读取文件流的用例会多一些。

如果你还需要其它一些功能，请详细的阅读 SendGridMessage 类型的 API，它基本上能够满足你所有的需求。

已知问题

如果你有一个非常顽固的用户，他要求你发出的邮件内容必须是纯文本的形式 (主要是为了保持手动创建的各种换行和缩进)，不能是 HTML 格式的，这将会是一个不小的挑战。因为 SendGrid 默认把邮件内容包成了 HTML 格式。不过我们还是有方法满足客户的，你可以尝试在每一行文本前面添加一个半角的空格，这也是 SendGrid 官方给出的方法。

其实，还有另外一种方式可以实现类似的效果。那就是把所有的文本内容放到 html 的<pre>元素中，代码也很简单：

message.Html = string.Format("<pre>{0}</pre>", System.Web.HttpUtility.HtmlEncode(message.Text));

总结

本文概要的介绍了在 Azure 上的 C# 应用中，如何使用 SendGrid 发送电子邮件。虽然代码不多，但描述了整个操作过程，希望对朋友们有所帮助。

相关阅读：

最全的Windows Azure学习教程汇总

Azure Blob Storage 基本用法 -- Azure Storage 之 Blob

Azure Queue Storage 基本用法 -- Azure Storage 之 Queue

Azure File Storage 基本用法 -- Azure Storage 之 File

Azure Table storage 基本用法 -- Azure Storage 之 Table