.NET Core使用FluentEmail发送邮件的示例代码
前言
在实际的项目开发中,我们会遇到许多需要通过程序发送邮件的场景,比如异常报警、消息、进度通知等等。一般情况下我们使用原生的SmtpClient类库居多,它能满足我们绝大多数场景。但是使用起来不够简洁,许多场景需要我们自行封装方法去实现,而且代码量非常可观。庆幸的是,我们有一款非常棒的组件,能满足我们绝大多数应用场景,而且使用简单功能强大,就是我们今天要说的FluentEmail,这也是我们实际在项目中正在使用的邮件发送组件。如果你们在.Net Core中有发送邮件的需求,也推荐去尝试一下。
FluentEmail
FluentEmail是一款在GitHub上开源免费的支持.Net和.Net Core邮件发送组件,目前已有1K多的Star,而且近两年随着.Net Core的日益成熟,它的Star增长趋势还是非常迅猛的。它在GitHub地址是https://github.com/lukencode/FluentEmail,它的功能非常强大而且非常实用,支持Razor的邮件模板和支持使用SendGrid,MailGun,SMTP发送邮件,而且使用也非常简单。
Nuget组件
FluentEmail功能强大,而且对不同场景的支持都有独立的Nuget包,这种低耦合的拆分不仅使得依赖非常清晰,而且避免引入不需要的代码,具体功能包含在以下的组件包中
- FluentEmail.Core - 基础核心包,包含了基础的模型定义和默认的设置,而且以下的引用包都包含了这个核心包。
- FluentEmail.Smtp - 使用SMTP服务发送邮件的程序包。
- FluentEmail.Razor - 通过Razor模板生成邮件发送内容。
- FluentEmail.Mailgun - 使用Mailgun的Rest接口发送邮件。
- FluentEmail.SendGrid - 使用SendGrid接口发送邮件。
- FluentEmail.Mailtrap - 发送邮件Mailtrap, 使用的是FluentEmail.Smtp包进行发送.
- FluentEmail.MailKit - 使用MailKit邮件库发送邮件。
普通邮件方式
接下来我们就演示一下如何使用FluentEmail发送邮件,由于我们实际业务中大多数都使用的SMTP的方式发送邮件,所以我们就以此为做演示,首先我们在项目中引入FluentEmail.Smtp包,目前最新版本为2.8.0
<PackageReference Include="FluentEmail.Smtp" Version="2.8.0" />
接下来我们就可以愉快的写代码了,它的编码使用方式非常简单而且非常简洁,主要通过链式编程的方式
//如果使用smtp服务发送邮件必须要设置smtp服务信息 SmtpClient smtp = new SmtpClient { //smtp服务器地址(我这里以126邮箱为例,可以依据具体你使用的邮箱设置) Host = "smtp.126.com", UseDefaultCredentials = true, DeliveryMethod = SmtpDeliveryMethod.Network, //这里输入你在发送smtp服务器的用户名和密码 Credentials = new NetworkCredential("邮箱用户名", "邮箱密码") }; //设置默认发送信息 Email.DefaultSender = new SmtpSender(smtp); var email = Email //发送人 .From("zhangsan@126.com") //收件人 .To("lisi@qq.com") //抄送人 .CC("admin@126.com") //邮件标题 .Subject("邮件标题") //邮件内容 .Body("邮件内容"); //依据发送结果判断是否发送成功 var result = email.Send(); //或使用异步的方式发送 //await email.SendAsync(); if (result.Successful) { //发送成功逻辑 } else { //发送失败可以通过result.ErrorMessages查看失败原因 }
如果你发送的内容中包含html格式的内容可以使用如下方式
var email = Email //发送人 .From("zhangsan@126.com") //收件人 .To("lisi@qq.com") //抄送人 .CC("admin@126.com") //邮件标题 .Subject("邮件标题") //只需要额外设置第二个参数为true即可 .Body("<h1 align=\"center\">.NET大法好</h1><p>是的,这一点毛病都没有</p>",true); //发送 var result = email.Send();
这个我们通过点击查看Body的方法声明即可得知第二个参数是用来表示内容是否为html格式,默认为false
IFluentEmail Body (string body, bool isHtml = false);
如果邮件的收件人为多个邮箱地址的话,可以采用To方法的另一个重载方法可以接受List<FluentEmail.Core.Models.Address>
var email = Email //发送人 .From("zhangsan@126.com") //邮件标题 .Subject("邮件标题") //邮件内容 .Body("<h1 align=\"center\">.NET大法好</h1><p>是的,一点毛病都没有</p>",true); //构建多个接收人邮箱 string toUserStr = "oldwang@126.com;xiaoming@163.com;xiaoli@qq.com"; List<FluentEmail.Core.Models.Address> toUsers = toUserStr.Split(";") .Select(i => new FluentEmail.Core.Models.Address { EmailAddress = i }).ToList(); //支持传入Address集合 email.To(toUsers) //抄送人集合 .CC(toUsers); //发送 var result = email.Send();
如果我们需要在发送的邮件中添加一个附件的话,可以使用Attache方法添加附件
var email = Email //发送人 .From("zhangsan@qq.com") //收件人 .To("lisi@126.com") //抄送人 .CC("admin@126.com") //邮件标题 .Subject("关于.Net Core怎么样") //邮件内容 .Body("<h1 align=\"center\">.NET Core</h1><p>.Net Core很优秀吗?是的,一点毛病都没有!!!</p>",true); //构建附件 var stream = new MemoryStream(); var sw = new StreamWriter(stream); sw.WriteLine("您好,这是文本里的内容"); sw.Flush(); stream.Seek(0, SeekOrigin.Begin); var attachment = new FluentEmail.Core.Models.Attachment { Data = stream, ContentType = "text/plain", Filename = "Hello.txt" }; //添加附件 email.Attach(attachment); var result = email.Send();
如果需要添加多个附件的话Attach方法支持传入Attachment集合
//构建附件 var stream = new MemoryStream(); var sw = new StreamWriter(stream); sw.WriteLine("您好,这是文本里的内容"); sw.Flush(); stream.Seek(0, SeekOrigin.Begin); //附件1 var attachment = new FluentEmail.Core.Models.Attachment { Data = stream, ContentType = "text/plain", Filename = "Hello.txt" }; //附件2 var attachment2 = new FluentEmail.Core.Models.Attachment { Data = File.OpenRead(@"D:\test.txt"), ContentType = "text/plain", Filename = "test.txt" }; //添加附件 email.Attach(new List<FluentEmail.Core.Models.Attachment> { attachment, attachment2 }); var result = email.Send();
使用Razor模板
上面的内容我们介绍了使用FluentEmail使用常规的方式发送邮件,但是有时候我们需要发送一些内容是动态的或者发送一些样式比较复杂html网页内容。通常我们使用原生的SmptClient的时候都是通过拼接html代码方式,但是这种方式相对来说比较费时费力,对于.Net程序员来说Razor引擎是我们构建动态html页面最熟悉的方式,而FluentEmail正是为我们提供了Razor模板的支持。首先,我们在之前的基础上引入FluentEmail.Razor模板支持组件
<PackageReference Include="FluentEmail.Razor" Version="2.8.0" />
由于ASP.NET Core2.2开始默认是使用的视图编译功能,视图会编译成 项目名称.Views.dll,但是FluentEmail.Razor又需要读取视图文件的内容,所以要在csproj文件中添加以下内容
<MvcRazorExcludeRefAssembliesFromPublish>true</MvcRazorExcludeRefAssembliesFromPublish>
然后我们就可以使用Razor模板生成邮件内容,具体的使用方式
//声明使用razor的方式 Email.DefaultRenderer = new RazorRenderer(); //razor内容 var template = "你好@Model.Name先生, 请核实您的电话号码是否为@Model.Phone"; var email = Email .From("lisi@126.com") .To("zhangsan@qq.com") .Subject("手机号核实") //传递自定义POCO类 //.UsingTemplate<UserInfo>(template, new UserInfo { Name = "张三", Phone吗 = "100110119120" }) //或传递匿名对象 .UsingTemplate(template, new { Name = "张三", Phone吗 = "100110119120" }); var result = await email.SendAsync();
当然它支持的方式不仅仅只是Razor字符串,还可以传递Razor视图文件
var email = Email .From("lisi@126.com") .To("zhangsan@qq.com") .Subject("手机号核实") //传递自定义POCO类 //.UsingTemplateFromFile<UserInfo>($"{Directory.GetCurrentDirectory()}/template.cshtml", // new UserInfo { Name = "张三", Phone吗 = "100110119120" }); //第一个参数为视图文件位置,第二个参数为模型对象 .UsingTemplateFromFile($"{Directory.GetCurrentDirectory()}/template.cshtml", new { Name = "张三", Phone吗 = "100110119120" }); var result = await email.SendAsync();
FluentEmail.Razor之所以能够支持强大的Razor模板引擎,主要是得益于它内部集成了RazorLight,这是一款非常强大的Razor引擎,可以将Razor模板字符串或者Razor视图文件解析成具体的字符串结果,具体详情可参阅RazorLight官方GitHub地址https://github.com/toddams/RazorLight,目前正式版并不支持.Net Core,可以选择下载beta版本
Install-Package RazorLight -Version 2.0.0-beta10
它的使用方式也非常简单
//razor字符串的方式 var engine = new RazorLightEngineBuilder() .UseEmbeddedResourcesProject(typeof(Program)) .UseMemoryCachingProvider() .Build(); string template = "Hello, @Model.Name. Welcome to RazorLight repository"; ViewModel model = new ViewModel {Name = "John Doe"}; //result就是解析后的字符串 string result = await engine.CompileRenderStringAsync("templateKey", template, model);
或使用razor视图文件的方式
var engine = new RazorLightEngineBuilder() .UseFileSystemProject("${Directory.GetCurrentDirectory()}") .UseMemoryCachingProvider() .Build(); var model = new {Name = "John Doe"}; string result = await engine.CompileRenderAsync("template.cshtml", model);
当然它支持的方式不仅仅只有这两种,无论是使用便捷程度还是功能上都非常的强大,有兴趣的同学可以自行查阅RazorLight的GitHub地址,讲解的还是非常详细的。在这里就不在过多的讨论关于RazorLight的使用方式了。
关于发送的邮件内容,这里有一个非常重要的点需要友情提示一下公共邮箱运营商比如网易或腾讯,有的可能需要手动开启SMTP服务,具体如何设置可以参考https://www.jb51.net/diannaojichu/520949.html一文。还有一点也比较重要如果你使用公共邮箱运营商的邮箱那么他们会对邮件的标题和内容限制比较大,可能出现的问题比较多,而且开启Smtp服务需要发送短信认证才能开启。好在大部分公司都有自己的邮件系统,在实际发送邮件的过程中可能不会存在这么多的问题。
结合依赖注入使用
在使用.Net Core的实际开发中,依赖注入已经成为了必不可少的开发模式。如果你正在使用.Net Core开发项目,但是你还没有接触依赖注入,那么需要你先自行反省一下。FluentEmail作为一款与时俱进的组件,也可以结合依赖注入使用,使用这种方式我们可以在注册的时候统一的配置一些默认的设置。这波操作就不需要额外引入一些别的包了,如果你需要使用Smtp就引入FluentEmail.Smtp包,如果你需要使用Razor模板就引入FluentEmail.Razor包,关于注入的这一部分的功能其实是包含在FluentEmail.Core包里面的
public void ConfigureServices(IServiceCollection services) { SmtpClient smtp = new SmtpClient { //smtp服务器地址(我这里以126邮箱为例,可以依据具体你使用的邮箱设置) Host = "smtp.qq.com", UseDefaultCredentials = true, DeliveryMethod = SmtpDeliveryMethod.Network, //这里输入你在发送smtp服务器的用户名和密码 Credentials = new NetworkCredential("zhangsan@qq.com", "zhangsan") }; //注入的时候可以添加一些默认的设置 services //设置默认发送用户 .AddFluentEmail("zhangsan@qq.com") //添加razor模板支持 //.AddRazorRenderer($"{Directory.GetCurrentDirectory()}/Views") .AddRazorRenderer() //配置默认的smtp服务信息 .AddSmtpSender(smtp); }
在需要发送邮件的类中直接注入IFluentEmail,不必惊慌咱们上面使用的Email这个类其实就是实现了IFluentEmail这个接口,所以使用方式上是完全一致的
public async Task<IActionResult> SendEmail([FromServices]IFluentEmail email) { var result = await email//发送人 //发送人 .From("zhangsan@126.com") //收件人 .To("lisi@qq.com") //抄送人 .CC("admin@126.com") //邮件标题 .Subject("邮件标题") //邮件内容 .Body("邮件内容").SendAsync(); return View(); }
如果你需要发送Razor视图模板相关的内容,也还是那个熟悉的配方那个熟悉的味道,没有任何的不同,只是省略了一些我们在注册的时候添加的一些默认配置
public async Task<IActionResult> SendEmail([FromServices]IFluentEmail email) { var result = await email//发送人 //发送人 .From("zhangsan@126.com") //收件人 .To("lisi@qq.com") //抄送人 .CC("admin@126.com") //邮件标题 .Subject("邮件标题") //邮件内容 .Body("邮件内容").SendAsync(); return View(); }
总结
关于FluentEmail的基本使用方式我们就介绍到这里,我个人感觉它自身的功能还是非常强大的,而且使用起来非常的简单。说实话在之前我没接触到FluentEmail之前,我经常在园子里看到其他语言集成发送邮件的组件,确实非常强大,比如在springboot中集成spring-boot-starter-mail真的是非常的便捷。后来无意中接触到了FluentEmail心里还是蛮欣慰的,一是它强大的功能和易用性,其次是可以去结合.Net Core进一步优化了它的使用方式,至少在.Net和.Net Core中我们也拥有一款非常便捷的邮件发送组件。FluentEmail的作者也呼吁更多的开发者能够了解并参与到FluentEmail开发和实践中去,最后再次贴上它的GitHub地址https://github.com/lukencode/FluentEmail
到此这篇关于.NET Core使用FluentEmail发送邮件的示例代码的文章就介绍到这了,更多相关.NET Core 发送邮件内容请搜索猪先飞以前的文章或继续浏览下面的相关文章希望大家以后多多支持猪先飞!
相关文章
- 这篇文章主要为大家详细介绍了ASP.NET购物车的实现过程,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...2021-09-22
- 这篇文章主要介绍了.NET Core下使用Kafka的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-09-22
- 在开发过程中,使用Visual Studio的断点调试功能可以很方便帮我们调试发现程序存在的错误,同样Visual Studio也支持对SQL Server里面的存储过程进行调试,下面就让我们看看具体的调试方法。...2021-09-22
- 这篇文章主要介绍了Win10 IIS 安装及.net 4.5及Win10安装IIS并配置ASP.NET 4.0的方法,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下...2021-09-22
- 这篇文章主要介绍了详解.NET Core 3.0 里新的JSON API,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-09-22
- 这篇文章主要介绍了.net数据库操作框架SqlSugar的简单入门,帮助大家更好的理解和学习使用.net技术,感兴趣的朋友可以了解下...2021-09-22
ASP.NET Core根据环境变量支持多个 appsettings.json配置文件
这篇文章主要介绍了ASP.NET Core根据环境变量支持多个 appsettings.json配置文件,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-09-22- 这篇文章主要介绍了记一次EFCore类型转换错误及解决方案,帮助大家更好的理解和学习使用asp.net core,感兴趣的朋友可以了解下...2021-09-22
- ZXing是一个开放源码的,用Java实现的多种格式的1D/2D条码图像处理库,它包含了联系到其他语言的端口。这篇文章主要给大家介绍了.NET C#利用ZXing生成、识别二维码/条形码的方法,文中给出了详细的示例代码,有需要的朋友们可以参考借鉴。...2020-06-25
详解ASP.NET Core 中基于工厂的中间件激活的实现方法
这篇文章主要介绍了ASP.NET Core 中基于工厂的中间件激活的实现方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-09-22- 这篇文章主要介绍了C#使用Ado.Net更新和添加数据到Excel表格的方法,较为详细的分析了OLEDB的原理与使用技巧,可实现较为方便的操作Excel数据,需要的朋友可以参考下...2020-06-25
asp.net通过消息队列处理高并发请求(以抢小米手机为例)
这篇文章主要介绍了asp.net通过消息队列处理高并发请求(以抢小米手机为例),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-09-22- Underscore 是一个 JavaScript 工具库,它提供了一整套函数式编程的实用功能,但是没有扩展任何 JavaScript 内置对象。这篇文章主要介绍了underscore源码分析相关知识,感兴趣的朋友一起学习吧...2016-01-02
ASP.NET单选按钮控件RadioButton常用属性和方法介绍
RadioButton又称单选按钮,其在工具箱中的图标为 ,单选按钮通常成组出现,用于提供两个或多个互斥选项,即在一组单选钮中只能选择一个...2021-09-22- 这篇文章主要介绍了c#使用netmail方式发送邮件的示例,大家参考使用吧...2020-06-25
ASP.NET 2.0中的数据操作:使用两个DropDownList过滤的主/从报表
在前面的指南中我们研究了如何显示一个简单的主/从报表, 该报表使用DropDownList和GridView控件, DropDownList填充类别,GridView显示选定类别的产品. 这类报表用于显示具有...2016-05-19详解.NET Core 使用HttpClient SSL请求出错的解决办法
这篇文章主要介绍了.NET Core 使用HttpClient SSL请求出错的解决办法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧...2021-09-22- 这篇文章主要介绍了Python调用.NET库的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-05-09
- PHPMailer在SAE上无法发送邮件怎么回事呢,我们以前在php5.2.7版本中使用了PHPMailer是可以发,但移到sae中发现无法发邮件了,那么此问题如何解决 在SAE上直接用5.2.7...2016-11-25
ASP.NET中iframe框架点击左边页面链接 右边显示链接页面内容
这篇文章主要介绍了ASP.NET中iframe框架点击左边页面链接,右边显示链接页面内容的实现代码,感兴趣的小伙伴们可以参考一下...2021-09-22