In this article I will explain with an example, how to send email asynchronously using
MailKit library in ASP.Net MVC.
Installing MailKit package
Mail Server Settings in Web.Config file
The following Mail Server settings need to be saved in the Web.Config file.
<system.net>
<mailSettings>
<smtp deliveryMethod="Network">
<network
host="smtp.gmail.com"
port="587"/>
</smtp>
</mailSettings>
</system.net>
Sending email Asynchronously using MailKit
MimeMessage class properties
Following are the required properties of the MimeMessage class.
From – Sender’s email address.
To – Recipient(s) Email Address.
CC – Carbon Copies. (If any)
BCC – Blind Carbon Copies. (If any)
Subject – Subject of the Email.
Body – Body of the Email.
Attachments – Attachments. (If any)
ReplyTo – ReplyTo Email address.
SmtpClient class methods
Following are the methods of the SMTP class.
Connect – The connection to the SMTP Server is established using the domain and the port number.
Authenticate – The username and password of the SMTP Server is authenticated.
Send – The MimeMessage object is passed to it and the email is sent
Disconnect – Disconnects the connection with SMTP Server.
Namespaces
You will need to import the following namespaces.
using MimeKit;
using MailKit.Net.Smtp;
using System.Threading;
using System.Configuration;
using System.Net.Configuration;
Controller
The Controller consists of the following Action methods.
Action method for handling GET operation
Inside this Action method, simply the View is returned.
Action method for handling POST operation
This Action method gets called, when Send Button is clicked which accepts EmailModel class object as parameter.
Inside this Action method, the Recipient email address (to), the Sender email address (from), Subject, Body and Password values are fetched from their respective fields which will be passed as parameter to SendEmailAsyncmethod.
The SendEmailAsync is executed using the Run method of Task class.
SendEmailAsync
The SendEmailAsync method is an asynchronous method which is created using async modifier.
Inside the SendEmailAsync method all these parameters are set into the respective properties of an object of the MimeMessage class.
Setting Body of Email
For Body, an object of Builder class is created. The Body of the email is Text (Non HTML) hence it is set into the TextBody property of the Builder class object.
After that, Builder class object is assigned to the Body property of MimeMessage class.
Sending Email
Then, an object of the SmtpClient class is created and the values of Host and Port are fetched from the SMTP section of the Web.Config file and are passed as parameter to the ConnectAsync method.
Finally, the methods of the Mail Server such as
ConnectAsync,
AuthenticateAsync,
SendAsync and
DisconnectAsync are executed using
await operator and a success message is set into a
ViewBag object.
public class HomeController : Controller
{
// GET: Home
public ActionResult Index()
{
return View();
}
[HttpPost]
public ActionResult Index(EmailModel model)
{
//Performing operations asynchronously.
bool status = Task.Run(() => this.SendEmailAsync(model.To, model.Email, model.Password, model.Subject, model.Body)).Result;
ViewBag.Message = "Email sent.";
return View();
}
private async Task<bool> SendEmailAsync(string to, string from, string password, string subject, string body)
{
//Read SMTP section from Web.Config.
SmtpSection smtpSection = (SmtpSection)ConfigurationManager.GetSection("system.net/mailSettings/smtp");
string host = smtpSection.Network.Host;
int port = smtpSection.Network.Port;
using (MimeMessage mm = new MimeMessage())
{
mm.From.Add(new MailboxAddress("Sender", from));
mm.To.Add(new MailboxAddress("Recepient", to));
mm.Subject = subject;
BodyBuilder builder = new BodyBuilder()
{
TextBody = body
};
mm.Body = builder.ToMessageBody();
using (SmtpClient smtp = new SmtpClient())
{
await smtp.ConnectAsync(host, port);
await smtp.AuthenticateAsync(from, password);
await smtp.SendAsync(mm);
await smtp.DisconnectAsync(true);
}
}
return true;
}
}
View
HTML Markup
Inside the View, in the very first line the EmailModel class is declared as model for the View.
The View consists of an HTML Form which has been created using the Html.BeginForm method with the following parameters.
ActionName – Name of the Action. In this case the name is Index.
ControllerName – Name of the Controller. In this case the name is Home.
FormMethod – It specifies the Form Method i.e. GET or POST. In this case it will be set to POST.
The Form consists of HTML TextBox, TextArea and a Submit Button.
Note: For more details in creating HTML TextBox, TextArea in ASP.Net MVC, please refer following articles.
When the Submit Button is clicked, the Form gets submitted and the Model object is sent to the Controller.
Finally, the
ViewBag object is checked for NULL and if it is not NULL then the value of the object is displayed using
JavaScript Alert Message Box.
@model Send_Email_Mailkit_MVC.Models.EmailModel
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Index</title>
</head>
<body>
@using (Html.BeginForm("Index", "Home", FormMethod.Post))
{
<table border="0" cellpadding="0" cellspacing="0">
<tr>
<td style="width: 80px">To:</td>
<td>@Html.TextBoxFor(model => model.To)</td>
</tr>
<tr>
<td>Subject:</td>
<td>@Html.TextBoxFor(model => model.Subject)</td>
</tr>
<tr>
<td valign="top">Body:</td>
<td>@Html.TextAreaFor(model => model.Body, new { rows = "3", cols = "20" })</td>
</tr>
<tr>
<td>Gmail Email:</td>
<td>@Html.TextBoxFor(model => model.Email)</td>
</tr>
<tr>
<td>Gmail Password:</td>
<td>@Html.TextBoxFor(model => model.Password, new { type = "password" })</td>
</tr>
<tr>
<td></td>
<td><input type="submit" value="Send" /></td>
</tr>
</table>
}
@if (ViewBag.Message != null)
{
<script type="text/javascript">
window.onload = function () {
alert("@ViewBag.Message");
};
</script>
}
</body>
</html>
Screenshots
Email Form
![Send async email using MailKit in ASP.Net MVC]()
Received Email
![Send async email using MailKit in ASP.Net MVC]()
Downloads
