This post is an example how to send email in Asp.net Core 3.1 using Mailkit. I assume that you have downloaded it and install it on your server.
How to Send HTML Email in ASP.NET Core
This code sends a simple HTML email using the Ethereal free SMTP testing service, you can create a free test account in one click at https://ethereal.email/ and copy the username and password from below the title SMTP configuration. See instructions below for using different SMTP providers such as Gmail and Hotmail.
1 2 3 4 5 6 7 8 9 10 11 12 13 | // create email message var email = new MimeMessage(); email.Subject = "Test Email Subject"; email.Body = new TextPart(TextFormat.Html) { Text = "<h1>Example HTML Message Body</h1>" }; // send email using var smtp = new SmtpClient(); smtp.Connect("smtp.ethereal.email", 587, SecureSocketOptions.StartTls); smtp.Authenticate("[USERNAME]", "[PASSWORD]"); smtp.Send(email); smtp.Disconnect(true); |
How to Send Plain Text Email in ASP.NET Core
This code sends the same email as above with a plain text body.
1 2 3 4 5 6 7 8 9 10 11 12 13 | // create email message var email = new MimeMessage(); email.Subject = "Test Email Subject"; email.Body = new TextPart(TextFormat.Plain) { Text = "Example Plain Text Message Body" }; // send email using var smtp = new SmtpClient(); smtp.Connect("smtp.ethereal.email", 587, SecureSocketOptions.StartTls); smtp.Authenticate("[USERNAME]", "[PASSWORD]"); smtp.Send(email); smtp.Disconnect(true); |
Change Your SMTP Provider
To change the above code to use a different email provider simply update the host parameter (the first parameter) passed to the smtp.Connect() method, for example:
1 2 3 4 5 6 7 8 | // gmail smtp.Connect("smtp.gmail.com", 587, SecureSocketOptions.StartTls); // hotmail smtp.Connect("smtp.live.com", 587, SecureSocketOptions.StartTls); // office 365 smtp.Connect("smtp.office365.com", 587, SecureSocketOptions.StartTls); |
Wrapping it up in an Email Service
To encapsulate the email sending functionality and make it easy to send email from anywhere in your ASP.NET Core application you can create an EmailService class and IEmailService interface like below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 | using MailKit.Net.Smtp; using MailKit.Security; using Microsoft.Extensions.Options; using MimeKit; using MimeKit.Text; using WebApi.Helpers; namespace WebApi.Services { public interface IEmailService { void Send(string from, string to, string subject, string html); } public class EmailService : IEmailService { private readonly AppSettings _appSettings; public EmailService(IOptions<AppSettings> appSettings) { _appSettings = appSettings.Value; } public void Send(string from, string to, string subject, string html) { // create message var email = new MimeMessage(); email.From.Add(MailboxAddress.Parse(from)); email.To.Add(MailboxAddress.Parse(to)); email.Subject = subject; email.Body = new TextPart(TextFormat.Html) { Text = html }; // send email using var smtp = new SmtpClient(); smtp.Connect(_appSettings.SmtpHost, _appSettings.SmtpPort, SecureSocketOptions.StartTls); smtp.Authenticate(_appSettings.SmtpUser, _appSettings.SmtpPass); smtp.Send(email); smtp.Disconnect(true); } } } |
Conclusion
I hope above tutorial can help you if you encounter issue when send email via your Asp.net Core application. See you on next tips!
