网站如何做宣传,软件开发自学入门教程,住建综合管理平台,wordpress固定连接如何设置前言在实际的项目开发中#xff0c;我们会遇到许多需要通过程序发送邮件的场景#xff0c;比如异常报警、消息、进度通知等等。一般情况下我们使用原生的SmtpClient类库居多#xff0c;它能满足我们绝大多数场景。但是使用起来不够简洁#xff0c;许多场景需要我们自行封装… 前言 在实际的项目开发中我们会遇到许多需要通过程序发送邮件的场景比如异常报警、消息、进度通知等等。一般情况下我们使用原生的SmtpClient类库居多它能满足我们绝大多数场景。但是使用起来不够简洁许多场景需要我们自行封装方法去实现而且代码量非常可观。庆幸的是我们有一款非常棒的组件能满足我们绝大多数应用场景而且使用简单功能强大就是我们今天要说的FluentEmail这也是我们实际在项目中正在使用的邮件发送组件。如果你们在.Net Core中有发送邮件的需求也推荐去尝试一下。FluentEmail FluentEmail是一款在GitHub上开源免费的支持.Net和.Net Core邮件发送组件目前已有1K多的Star而且近两年随着.Net Core的日益成熟它的Star增长趋势还是非常迅猛的。它在GitHub地址是https://github.com/lukencode/FluentEmail它的功能非常强大而且非常实用支持Razor的邮件模板和支持使用SendGridMailGunSMTP发送邮件而且使用也非常简单。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.0PackageReference IncludeFluentEmail.Smtp Version2.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(zhangsan126.com)//收件人.To(lisiqq.com)//抄送人.CC(admin126.com)//邮件标题.Subject(邮件标题)//邮件内容.Body(邮件内容);
//依据发送结果判断是否发送成功
var result email.Send();
//或使用异步的方式发送
//await email.SendAsync();
if (result.Successful)
{//发送成功逻辑
}
else
{//发送失败可以通过result.ErrorMessages查看失败原因
}
如果你发送的内容中包含html格式的内容可以使用如下方式var email Email//发送人.From(zhangsan126.com)//收件人.To(lisiqq.com)//抄送人.CC(admin126.com)//邮件标题.Subject(邮件标题)//只需要额外设置第二个参数为true即可.Body(h1 align\center\.NET大法好/h1p是的,这一点毛病都没有/p,true);
//发送
var result email.Send();
这个我们通过点击查看Body的方法声明即可得知第二个参数是用来表示内容是否为html格式默认为falseIFluentEmail Body (string body, bool isHtml false);
如果邮件的收件人为多个邮箱地址的话,可以采用To方法的另一个重载方法可以接受ListFluentEmail.Core.Models.Addressvar email Email//发送人.From(zhangsan126.com)//邮件标题.Subject(邮件标题)//邮件内容.Body(h1 align\center\.NET大法好/h1p是的,一点毛病都没有/p,true);//构建多个接收人邮箱
string toUserStr oldwang126.com;xiaoming163.com;xiaoliqq.com;
ListFluentEmail.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(zhangsanqq.com)//收件人.To(lisi126.com)//抄送人.CC(admin126.com)//邮件标题.Subject(关于.Net Core怎么样)//邮件内容.Body(h1 align\center\.NET Core/h1p.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 ListFluentEmail.Core.Models.Attachment { attachment, attachment2 });
var result email.Send();
使用Razor模板 上面的内容我们介绍了使用FluentEmail使用常规的方式发送邮件但是有时候我们需要发送一些内容是动态的或者发送一些样式比较复杂html网页内容。通常我们使用原生的SmptClient的时候都是通过拼接html代码方式但是这种方式相对来说比较费时费力对于.Net程序员来说Razor引擎是我们构建动态html页面最熟悉的方式而FluentEmail正是为我们提供了Razor模板的支持。首先我们在之前的基础上引入FluentEmail.Razor模板支持组件PackageReference IncludeFluentEmail.Razor Version2.8.0 /
由于ASP.NET Core2.2开始默认是使用的视图编译功能视图会编译成 项目名称.Views.dll但是FluentEmail.Razor又需要读取视图文件的内容所以要在csproj文件中添加以下内容MvcRazorExcludeRefAssembliesFromPublishtrue/MvcRazorExcludeRefAssembliesFromPublish
然后我们就可以使用Razor模板生成邮件内容具体的使用方式//声明使用razor的方式
Email.DefaultRenderer new RazorRenderer();
//razor内容
var template 你好Model.Name先生, 请核实您的电话号码是否为Model.Phone;
var email Email.From(lisi126.com).To(zhangsanqq.com).Subject(手机号核实)//传递自定义POCO类//.UsingTemplateUserInfo(template, new UserInfo { Name 张三, Phone吗 100110119120 })//或传递匿名对象.UsingTemplate(template, new { Name 张三, Phone吗 100110119120 });
var result await email.SendAsync();
当然它支持的方式不仅仅只是Razor字符串还可以传递Razor视图文件var email Email.From(lisi126.com).To(zhangsanqq.com).Subject(手机号核实)//传递自定义POCO类//.UsingTemplateFromFileUserInfo(${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://blog.csdn.net/c13_tianming/article/details/47660635一文。还有一点也比较重要如果你使用公共邮箱运营商的邮箱那么他们会对邮件的标题和内容限制比较大可能出现的问题比较多而且开启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(zhangsanqq.com, zhangsan)};//注入的时候可以添加一些默认的设置services//设置默认发送用户.AddFluentEmail(zhangsanqq.com)//添加razor模板支持//.AddRazorRenderer(${Directory.GetCurrentDirectory()}/Views).AddRazorRenderer()//配置默认的smtp服务信息.AddSmtpSender(smtp);
}
在需要发送邮件的类中直接注入IFluentEmail,不必惊慌咱们上面使用的Email这个类其实就是实现了IFluentEmail这个接口所以使用方式上是完全一致的public async TaskIActionResult SendEmail([FromServices]IFluentEmail email)
{var result await email//发送人//发送人.From(zhangsan126.com)//收件人.To(lisiqq.com)//抄送人.CC(admin126.com)//邮件标题.Subject(邮件标题)//邮件内容.Body(邮件内容).SendAsync();return View();
}
如果你需要发送Razor视图模板相关的内容也还是那个熟悉的配方那个熟悉的味道没有任何的不同只是省略了一些我们在注册的时候添加的一些默认配置public async TaskIActionResult SendEmail([FromServices]IFluentEmail email)
{var template 你好Model.Name先生, 请核实您的电话号码是否为Model.Phone;var result await email//发送人.From(lisi126.com).To(zhangsanqq.com).Subject(手机号核实)//传递自定义POCO类//.UsingTemplateUserInfo(template, new UserInfo { Name 张三, Phone吗 100110119120 })//或传递匿名对象.UsingTemplate(template, new { Name 张三, Phone吗 100110119120 }).SendAsync();return View();
}
总结 关于FluentEmail的基本使用方式我们就介绍到这里我个人感觉它自身的功能还是非常强大的而且使用起来非常的简单。说实话在之前我没接触到FluentEmail之前我经常在园子里看到其他语言集成发送邮件的组件确实非常强大比如在springboot中集成spring-boot-starter-mail真的是非常的便捷。后来无意中接触到了FluentEmail心里还是蛮欣慰的一是它强大的功能和易用性其次是可以去结合.Net Core进一步优化了它的使用方式至少在.Net和.Net Core中我们也拥有一款非常便捷的邮件发送组件。FluentEmail的作者也呼吁更多的开发者能够了解并参与到FluentEmail开发和实践中去最后再次贴上它的GitHub地址https://github.com/lukencode/FluentEmail有兴趣的可以去了解学习一下顺便别忘了给个Star。????欢迎扫码关注我的公众号????
