Twilio SendGrid C .NET 库技术文档
1. 安装指南
准备条件
- .NET Framework 4.0+
- .NET Core 1.0+
- .NET Standard 1.3+
- Twilio SendGrid 账户,免费注册可在前30天内发送最多40,000封邮件,之后每天可免费发送100封邮件或查看我们的定价。
获取 API Key
从 Twilio SendGrid UI 获取您的 API Key。
设置环境变量以管理 API Key
通过环境变量或 Web.config 来管理您的 Twilio SendGrid API Key,这是一个好习惯,可以将数据配置设置与代码分离。这样,您可以在不更改代码的情况下更改 Twilio SendGrid API Key。
使用 UI 设置环境变量:
- 按下 Win+R 并运行 SystemPropertiesAdvanced
- 点击环境变量
- 在用户变量部分点击新建
- 在名称中输入 SENDGRID_API_KEY(确保名称与代码中的键名称匹配)
- 在值中输入实际的 API Key
- 重启 IDE,完成设置
使用 CMD 设置环境变量:
- 以管理员身份运行 CMD
- 运行
set SENDGRID_API_KEY="YOUR_API_KEY"
以下是一些以编程方式获取和设置 API Key 的示例:
// 获取环境变量
var apiKey = Environment.GetEnvironmentVariable("SENDGRID_API_KEY");
// 设置环境变量
var setKey = Environment.SetEnvironmentVariable("SENDGRID_API_KEY", "YOUR_API_KEY");
安装包
要在您的 C# 项目中使用 Twilio SendGrid,您可以直接从我们的 GitHub 仓库 下载 Twilio SendGrid C# .NET 库,或者如果您已安装 NuGet 包管理器,可以自动获取:
dotnet add package SendGrid
# 使用 HttpClientFactory 和 Microsoft.Extensions.DependencyInjection
dotnet add package SendGrid.Extensions.DependencyInjection
安装完 Twilio SendGrid 库后,您可以在代码中调用它。有关示例实现,请参阅 .NET Core 示例 和 .NET 4.5.2 示例 文件夹。
依赖项
请查看 .csproj 文件 中的依赖项。
2. 项目使用说明
快速入门
以下是最小代码示例,用于发送简单邮件。请使用此示例,并修改 apiKey
、from
和 to
变量:
using System;
using System.Threading.Tasks;
using SendGrid;
using SendGrid.Helpers.Mail;
class Program
{
static async Task Main()
{
var apiKey = Environment.GetEnvironmentVariable("SENDGRID_API_KEY");
var client = new SendGridClient(apiKey);
var from = new EmailAddress("test@example.com", "Example User");
var subject = "Sending with Twilio SendGrid is Fun";
var to = new EmailAddress("test@example.com", "Example User");
var plainTextContent = "and easy to do anywhere, even with C#";
var htmlContent = "<strong>and easy to do anywhere, even with C#</strong>";
var msg = MailHelper.CreateSingleEmail(from, to, subject, plainTextContent, htmlContent);
var response = await client.SendEmailAsync(msg).ConfigureAwait(false);
}
}
执行上述代码后,response.StatusCode
应该为 202
,并且您应该在 to
收件人的收件箱中收到一封邮件。您可以在 UI 中查看邮件状态。或者,我们可以将事件发布到您选择的 URL,使用我们的 事件 Webhook。这将为您提供 Twilio SendGrid 处理邮件时的有关事件数据。
对于更高级的情况,您可以自己构建 SendGridMessage 对象,至少需要以下设置:
using System;
using System.Threading.Tasks;
using SendGrid;
using SendGrid.Helpers.Mail;
class Program
{
static async Task Main()
{
var apiKey = Environment.GetEnvironmentVariable("SENDGRID_API_KEY");
var client = new SendGridClient(apiKey);
var msg = new SendGridMessage()
{
From = new EmailAddress("test@example.com", "DX Team"),
Subject = "Sending with Twilio SendGrid is Fun",
PlainTextContent = "and easy to do anywhere, even with C#",
HtmlContent = "<strong>and easy to do anywhere, even with C#</strong>"
};
msg.AddTo(new EmailAddress("test@example.com", "Test User"));
var response = await client.SendEmailAsync(msg).ConfigureAwait(false);
}
}
您可以在此处找到所有邮件功能的示例。
通用 v3 Web API 使用
using System;
using System.Threading.Tasks;
using SendGrid;
class Program
{
static async Task Main()
{
var apiKey = Environment.GetEnvironmentVariable("SENDGRID_API_KEY");
var client = new SendGridClient(apiKey);
var queryParams = @"{'limit': 100}";
var response = await client.RequestAsync(method: SendGridClient.Method.GET, urlPath: "suppression/bounces", queryParams: queryParams).ConfigureAwait(false);
}
}
HttpClientFactory + Microsoft.Extensions.DependencyInjection
using System;
using System.Threading.Tasks;
using Microsoft.Extensions.DependencyInjection;
using SendGrid;
using SendGrid.Extensions.DependencyInjection;
using SendGrid.Helpers.Mail;
class Program
{
static async Task Main()
{
var services = ConfigureServices(new ServiceCollection()).BuildServiceProvider();
var client = services.GetRequiredService<ISendGridClient>();
var msg = new SendGridMessage()
{
From = new EmailAddress("test@example.com", "Example User"),
Subject = "Sending with Twilio SendGrid is Fun"
};
msg.AddContent(MimeType.Text, "and easy to do anywhere, even with C#");
msg.AddTo(new EmailAddress("test@example.com", "Example User"));
var response = await client.SendEmailAsync(msg).ConfigureAwait(false);
}
private static IServiceCollection ConfigureServices(IServiceCollection services)
{
services.AddSendGrid(options =>
{
options.ApiKey = Environment.GetEnvironmentVariable("SENDGRID_API_KEY");
});
return services;
}
}
Web 代理
var apiKey = Environment.GetEnvironmentVariable("SENDGRID_API_KEY");
var proxy = new WebProxy("http://proxy:1337");
var client = new SendGridClient(proxy, apiKey);
或者在使用 DependencyInjection 时:
services.AddSendGrid(options =>
{
options.ApiKey = Environment.GetEnvironmentVariable("SENDGRID_API_KEY");
})
.ConfigurePrimaryHttpMessageHandler(_ => new HttpClientHandler()
{
Proxy = new WebProxy(new Uri("http://proxy:1337")),
UseProxy = true
});
3. 项目 API 使用文档
请参考以下文档以获取关于 Twilio SendGrid API 的详细信息:
4. 项目安装方式
请按照以下步骤安装 Twilio SendGrid C# .NET 库:
- 通过 NuGet 包管理器自动获取:
dotnet add package SendGrid
- 使用 HttpClientFactory 和 Microsoft.Extensions.DependencyInjection:
dotnet add package SendGrid.Extensions.DependencyInjection
-
从 GitHub 仓库 下载库文件。
-
将库文件添加到您的 C# 项目中,并根据需要调用相关功能。
HunyuanImage-3.0
HunyuanImage-3.0 统一多模态理解与生成,基于自回归框架,实现文本生成图像,性能媲美或超越领先闭源模型00- DDeepSeek-V3.2-ExpDeepSeek-V3.2-Exp是DeepSeek推出的实验性模型,基于V3.1-Terminus架构,创新引入DeepSeek Sparse Attention稀疏注意力机制,在保持模型输出质量的同时,大幅提升长文本场景下的训练与推理效率。该模型在MMLU-Pro、GPQA-Diamond等多领域公开基准测试中表现与V3.1-Terminus相当,支持HuggingFace、SGLang、vLLM等多种本地运行方式,开源内核设计便于研究,采用MIT许可证。【此简介由AI生成】Python00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0370Hunyuan3D-Part
腾讯混元3D-Part00ops-transformer
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。C++099AI内容魔方
AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。02Spark-Chemistry-X1-13B
科大讯飞星火化学-X1-13B (iFLYTEK Spark Chemistry-X1-13B) 是一款专为化学领域优化的大语言模型。它由星火-X1 (Spark-X1) 基础模型微调而来,在化学知识问答、分子性质预测、化学名称转换和科学推理方面展现出强大的能力,同时保持了强大的通用语言理解与生成能力。Python00GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile09
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
项目优选









