In this article I will explain with an example, how to send email with HTML Templates using MailKit in ASP.Net using C# and VB.Net.
 
 

Installing MailKit package

You will need to install the MailKit package, for details on installation please refer Install MailKit from Nuget in Visual Studio.
 
 

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" from="sender@gmail.com">
      <network
          host="smtp.gmail.com"
          port="587"
          userName="sender@gmail.com"
          password="GMAILor2STEP-PASSWORD" />
    </smtp>
 </mailSettings>
</system.net>
 
 

Adding Email Template

The very first step is to Right Click the Project in the Solution Explorer and click Add and then New Item and then select HTML Page and name it as EmailTemplate.htm.
Send Email with HTML Templates using MailKit in ASP.Net
 
 

Location of the EmailTemplate

The EmailTemplate is placed inside the Template Folder (Directory) in Project Folder.
Send Email with HTML Templates using MailKit in ASP.Net
 
 

Building HTML Template for Email Body

The HTML Template of the Email will be built by generating an HTML containing some placeholders which will be replaced with the actual content.
Advantage of creating templates instead of building HTML using String Builder class or String concatenation in code is that, one can easily change the HTML of the template without changing the code.
The following HTML Email Template consists of four placeholders:
{UserName} – Name of the recipient.
{Url} – Url of the article.
{Title} – Title of the article.
{Description} – Description of the Article.
These placeholders will be replaced with the actual (real) values, when the email is being sent.
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title></title>
</head>
<body>
    <img style="background:black;" src="https://www.aspsnippets.com/assets/img/logo_ns.png"/><br /><br />
    <div style="border-top:3px solid #61028D">&nbsp;</div>
    <span style="font-family:Arial; font-size:10pt">
        Hello <b>{UserName}</b>,<br /><br />
        A new article has been published on ASPSnippets.<br /><br/>
        <a style="color:#61028D" href="{Url}">{Title}</a><br />
        {Description}
        <br /><br />
        Thanks<br />
        ASPSnippets
    </span>
</body>
</html>
 
 

HTML Markup

The HTML Markup consists of following control:
Button – For sending email.
The Button has been assigned with an OnClick event handler.
<asp:Button ID="btnSend" runat="server" Text="Send" OnClick="SendEmail" />
 
 

Namespaces

You will need to import the following namespaces.
C#
using MimeKit;
using MailKit.Net.Smtp;
using System.IO;
using System.Configuration;
using System.Net.Configuration;
using MailKit.Security;
 
VB.Net
Imports MimeKit
Imports MailKit.Net.Smtp
Imports System.IO
Imports System.Configuration
Imports System.Net.Configuration
Imports MailKit.Security
 
 

Sending Email with HTML Templates 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.
 
 

Send Email with HTML Templates using MailKit in ASP.Net

When the SendEmail Button is clicked, the PopulateBody method is called and contents of the HTML Email Template file are read using the StreamReader class.
The placeholders are replaced with their respective values and finally the contents of the HTML Email Template are returned.
Next, the formatted HTML body, email address (recepientEmail) and Subject are set into the respective properties of the object of 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.
Sending Email
Then, an object of the SmtpClient class is created and the values of Host, Port, UserName, Password and Sender email address (from) fetched from the SMTP section of the Web.Config file are passed as parameter to the Connect method along with the SecureSocketOptions set to Auto.
Note: Setting Auto allows MailKit service to decide which SSL or TLS option to use. Hence, enabling SSL is not required.
 
Also, the CheckCertificateRevocation is set to FALSE.
Note: This is optional and must be used only when Certificate errors are occurring.
 
Finally, the methods of the Mail Server such as Connect, Authenticate, Send and Disconnect are executed and a success message is displayed in JavaScript Alert MessageBox using RegisterStartupScript method.
C#
protected void SendEmail(object sender, EventArgs e)
{
    string body = this.PopulateBody("John",
        "Fetch multiple values as Key Value pair in ASP.Net AJAX AutoCompleteExtender",
        "https://www.aspsnippets.com/Articles/190/Fetch-multiple-values-as-Key-Value-pair-in-ASP.Net-AJAX-AutoCompleteExtender/",
        "Here Mudassar Khan has explained with an example, how to fetch multiple column values i.e." +
        " ID and Text values in the ASP.Net AJAX Control Toolkit AutocompleteExtender" +
        " and also how to fetch the select text and value server side on postback.");
 
    //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;
    string userName = smtpSection.Network.UserName;
    string password = smtpSection.Network.Password;
 
    using (MimeMessage mm = new MimeMessage())
    {
        mm.From.Add(new MailboxAddress("Sender", smtpSection.From));
        mm.To.Add(new MailboxAddress("Recepient", "recepient@gmail.com"));
        mm.Subject = "New article published!";
        BodyBuilder builder = new BodyBuilder()
        {
            HtmlBody = body
        };
        mm.Body = builder.ToMessageBody();
        using (SmtpClient smtp = new SmtpClient())
        {
            //Set to False to avoid Certificate verification
            smtp.CheckCertificateRevocation = false;
            smtp.Connect(host, port, SecureSocketOptions.Auto);
            smtp.Authenticate(userName, password);
            smtp.Send(mm);
            smtp.Disconnect(true);
        }
    }
    ClientScript.RegisterStartupScript(this.GetType(), "alert", "alert('Email sent.')", true);
}
 
private string PopulateBody(string userName, string title, string url, string description)
{
    string body = string.Empty;
    using (StreamReader reader = new StreamReader(Server.MapPath("~/Template/EmailTemplate.html")))
    {
        body = reader.ReadToEnd();
    }
    body = body.Replace("{UserName}", userName);
    body = body.Replace("{Title}", title);
    body = body.Replace("{Url}", url);
    body = body.Replace("{Description}", description);
    return body;
}
 
VB.Net
Protected Sub SendEmail(ByVal sender As Object, ByVal e As EventArgs)
    Dim body As String = Me.PopulateBody("John", "Fetch multiple values as Key Value pair in ASP.Net AJAX AutoCompleteExtender",
                                            "https://www.aspsnippets.com/Articles/190/Fetch-multiple-values-as-Key-Value-pair-in-ASP.Net-AJAX-AutoCompleteExtender/",
                                            "Here Mudassar Khan has explained with an example, how to fetch multiple column values i.e." _
                                            & " ID and Text values in the ASP.Net AJAX Control Toolkit AutocompleteExtender" _
                                            & " and also how to fetch the select text and value server side on postback.")      
 
    'Read SMTP section from Web.Config.
    Dim smtpSection As SmtpSection = CType(ConfigurationManager.GetSection("system.net/mailSettings/smtp"), SmtpSection)
    Dim host As String = smtpSection.Network.Host
    Dim port As String = smtpSection.Network.Port
    Dim userName As String = smtpSection.Network.UserName
    Dim password As String = smtpSection.Network.Password
 
    Using mm As MimeMessage = New MimeMessage()
        mm.From.Add(New MailboxAddress("Sender", smtpSection.From))
        mm.[To].Add(New MailboxAddress("Recepient", "recepient@gmail.com"))
        mm.Subject = "New article published!"
        Dim builder As BodyBuilder = New BodyBuilder()
        {
            .HtmlBody = body
        }
        mm.Body = builder.ToMessageBody()
        Using smtp As SmtpClient = New SmtpClient()
            'Set to False to avoid Certificate verification.
            smtp.CheckCertificateRevocation = False
            smtp.Connect(host, port, SecureSocketOptions.Auto)
            smtp.Authenticate(userName, password)
            smtp.Send(mm)
            smtp.Disconnect(True)
        End Using
    End Using
    ClientScript.RegisterStartupScript(Me.GetType(), "alert", "alert('Email sent.')", True)
End Sub
 
Private Function PopulateBody(ByVal userName As String, ByVal title As String, ByVal url As String, ByVal description As String) As String
    Dim body As String = String.Empty
    Using reader As StreamReader = New StreamReader(Server.MapPath("~/Template/EmailTemplate.html"))
        body = reader.ReadToEnd()
    End Using
    body = body.Replace("{UserName}", userName)
    body = body.Replace("{Title}", title)
    body = body.Replace("{Url}", url)
    body = body.Replace("{Description}", description)
    Return body
End Function
 
 

Possible Errors

The possible errors (exceptions) occurring while sending email with MailKit in .Net are covered in the following article.
Errors (Exceptions) while sending email with MailKit in .Net.
 
 

Screenshot

Send Email with HTML Templates using MailKit in ASP.Net
 
 

Downloads

Download Code