Send Email Using Templates In ASP.NET Core (2024)

In this article, we will discuss how to send emails using a Template file in ASP.NET Core Application. Sending email using Template file is similar to sending emails using plain text. The only difference is that now, the source of the content is a text file rather than direct content for email.

If you don’t know how to send email in ASP.NET Core applications, please refer to my previous article Configure Email Service In ASP.NET Core Using MailKit. Let's assume, we have already configured email service in ASP.NET Core application.

Milestones

Create a Simple Email Template.
Configure Email Setting in ASP.NET Core Application.
Read content from Email Template using StreamReader()
Personalize Email Content
Send Email to User

Creating a Simple Email TemplateWe will keep the template file separate so that we can change the file design and content anytime. Let's keep these template files under wwwroot => Templates => EmailTemplate.

Step 1

For this, create a new folder named Templates under wwwroot folder.

Step 2

Create a new folder named Email Template under Templates folder.

Step 3Add a new Item in Email Template (right click on Email Template folder >> add New Item).

Step 4Select ASP.NET Core and then HTML Page.

Step 5Set a name for the HTML file. In my case, I have named it as Welcome_EmailTemplate.html (But I will be usingConfirm_Account_Registration.htmlfor demo purposes whose design is the same with a different file name).

Once you have created Email Templates, the Solution Explorer looks like below. (In my case, there are 5 Email Templates)

Now, you can write your own design codes using inline CSS and HTML to create Email. In my case, the template looks like this -

The code for the above sample Email Template is given below.

Code Snippet

Step 2get wwwroot Folder

var webRoot = _env.WebRootPath; //get wwwroot Folder

Step 3Get TemplateFile located at wwwroot/Templates/EmailTemplate/Register_EmailTemplate.html

//GetTemplateFilelocatedatwwwroot/Templates/EmailTemplate/Register_EmailTemplate.html
varpathToFile=_env.WebRootPath
+Path.DirectorySeparatorChar.ToString()
+"Templates"
+Path.DirectorySeparatorChar.ToString()
+"EmailTemplate"
+Path.DirectorySeparatorChar.ToString()
+"Confirm_Account_Registration.html";

Step 4Initialie BoduBuilder()

var builder = new BodyBuilder();

Step 5Read Content of Template file using StreamReader and append to BodyBuilder()

using (StreamReader SourceReader = System.IO.File.OpenText(pathToFile))
{
builder.HtmlBody = SourceReader.ReadToEnd();
}

Passing value and Formatting the Content of Template with Dynamic Values

Step 1use string.Format(format item, dynamic values as parameters) In our case, {x} values in Templates are to replace by dynamic values.

//{0}:Subject
//{1}:CurrentDateTime
//{2}:Email
//{3}:Username
//{4}:Password
//{5}:Message
//{6}:callbackURL

Code Snippet

stringmessageBody=string.Format(builder.HtmlBody,
subject,
String.Format("{0:dddd,dMMMMyyyy}",DateTime.Now),
model.Email,
model.Email,
model.Password,
Message,
callbackUrl
);

Send Email using MailkitIf you don’t know how to send email using Mail kit in ASP.NET Core Applications please refer to my previous blog. For now I am skipping setting up email service.

await_emailSender.SendEmailAsync(model.Email,subject,messageBody);
//SuccessMessageViewData["Message"]=$"Pleaseconfirmyouraccountbyclickingthislink:<ahref='{callbackUrl}'class='btnbtn-primary'>ConfirmationLink</a>";
ViewData["MessageValue"]="1";

await _emailSender.SendEmailAsync(model.Email, subject, messageBody); line will send email to user email.

Code used in Register Method of Account Controller

//POST:/Account/Register
[HttpPost]
[AllowAnonymous]
[ValidateAntiForgeryToken]
publicasyncTask<IActionResult>Register(RegisterViewModelmodel,stringreturnUrl=null)
{
ViewData["ReturnUrl"]=returnUrl;
if(ModelState.IsValid)
{
varuser=newApplicationUser{UserName=model.Email,Email=model.Email};
varresult=await_userManager.CreateAsync(user,model.Password);
//varuser=await_userManager.FindByEmailAsync(model.Email);
if(result.Succeeded)
{
//Sendanemailwiththislink
varcode=await_userManager.GenerateEmailConfirmationTokenAsync(user);
varcallbackUrl=Url.Action(nameof(ConfirmEmail),"Account",new{userId=user.Id,code=code},protocol:HttpContext.Request.Scheme);
//EmailfromEmailTemplate
stringMessage="Pleaseconfirmyouraccountbyclicking<ahref=\""+callbackUrl+"\">here</a>";
//stringbody;
varwebRoot=_env.WebRootPath;//getwwwrootFolder
//GetTemplateFilelocatedatwwwroot/Templates/EmailTemplate/Register_EmailTemplate.html
varpathToFile=_env.WebRootPath
+Path.DirectorySeparatorChar.ToString()
+"Templates"
+Path.DirectorySeparatorChar.ToString()
+"EmailTemplate"
+Path.DirectorySeparatorChar.ToString()
+"Confirm_Account_Registration.html";
varsubject="ConfirmAccountRegistration";
varbuilder=newBodyBuilder();
using(StreamReaderSourceReader=System.IO.File.OpenText(pathToFile))
{
builder.HtmlBody=SourceReader.ReadToEnd();
}
//{0}:Subject
//{1}:DateTime
//{2}:Email
//{3}:Username
//{4}:Password
//{5}:Message
//{6}:callbackURL
stringmessageBody=string.Format(builder.HtmlBody,
subject,
String.Format("{0:dddd,dMMMMyyyy}",DateTime.Now),
model.Email,
model.Email,
model.Password,
Message,
callbackUrl
);
await_emailSender.SendEmailAsync(model.Email,subject,messageBody);
ViewData["Message"]=$"Pleaseconfirmyouraccountbyclickingthislink:<ahref='{callbackUrl}'class='btnbtn-primary'>ConfirmationLink</a>";
ViewData["MessageValue"]="1";
_logger.LogInformation(3,"Usercreatedanewaccountwithpassword.");
returnRedirectToLocal(returnUrl);
}
ViewData["Message"]=$"Errorcreatinguser.Pleasetryagainlater";
ViewData["MessageValue"]="0";
AddErrors(result);
}
//Ifwegotthisfar,somethingfailed,redisplayform
returnView(model);
}

Appplication Execution and Output

Step 1Now let's rebuild the soution and run the application.

Step 2

Lets register as a New user /Account/Register

Once we register as new user, a confirmation email is sent on the registred email. Upon checking the email inbox, we receive email like this -

We receive the personalized email sent from the Demo ASP.NET Core Application.

Scenerio where we need Email Templates

Send personalized emails to all/selected users for events and news.
Newsletter
Notices and Call for events
Welcome Email to New Users.
Automatic Monthly report to Admins and Staffs.
and many more....

SummarySo far, we have learned how to send personalized emails to users creating Email Templates .

You may also like

How to configure Email Services in ASP.NET Core Applications.
How to export data to Excel from Web API in ASP.NET Core using Kendo UI
Sorting and Grouping in Kendo Grid using Web API in ASP.NET Core Application
Call Web API Using JQuery AJAX In ASP.NET Core Web Applications
How to create Image Thumbnail in ASP.NET Web Application

Send Email Using Templates In ASP.NET Core (2024)

FAQs

How do I send an email template in .NET core? ›

Sending Emails in ASP.NET Core

Step #1 – Create an email template.
Step #2 – Create a new model.
Step #3 – Make changes to IMailService and MailService.
Step #4 – Add a new method in the Mail controller.

Mar 9, 2023

Tell Me More ›

Are email templates effective? ›

Email templates can be an extremely effective way to save time and improve the likelihood that your sales message will land with your prospects. Your emails will look better and take less time to craft —and you'll never be caught staring anxiously at a blank screen.

Know More ›

How to send email using email template in C#? ›

var mailMessage = new MailMessage { From = new MailAddress("email"), Subject = "subject", Body = "<h1>Hello</h1>", IsBodyHtml = true, }; mailMessage. To. Add("recipient"); smtpClient. Send(mailMessage);

Get More Info ›

How to send an email in ASP.NET Core? ›

To send an email in ASP.NET Core Web API, we will use an interface and a class to define a method for sending an email. Through dependency injection, we will call that method in an API controller.

Tell Me More ›

How do I send an email using a template? ›

Insert a template

Open Gmail and click Compose.
Click More. Templates.
To insert a template, under Insert template, choose a saved template to insert in your email.
Compose the rest of your message and click Send.

Know More ›

Is SmtpClient obsolete? ›

Allows applications to send email by using the Simple Mail Transfer Protocol (SMTP). The SmtpClient type is obsolete on some platforms and not recommended on others; for more information, see the Remarks section.

Get More Info Here ›

What is one of the benefits of using templates for your email? ›

Templates are an essential component of email marketing campaigns. They provide a structured framework that ensures consistency in your email design and messaging. One of the benefits of using templates for your email marketing campaigns is the ability to save time.

Get More Info ›

Why you should use email templates? ›

You have control over the primary messaging when you use templates so that each correspondence will be professional. Also, templates contain contact and other relevant information in the same place, making it easier for customers to find what they're looking for when perusing emails.

Read On ›

What is the purpose of using email templates? ›

Email templates are pre-written messages that you can use to communicate with your clients, customers, or colleagues. They can save you time, improve your consistency, and enhance your professionalism.

Show Me More ›

How to send email automatically using ASP.NET C#? ›

Credentials = new NetworkCredential("SMTP_USERNAME", "SMTP_PASSWORD"); smtp. Send(new MailMessage("fromAddress@example.com", "toAddress@example.com", "Hello world", "testbody")); Run the code, and if everything seems to be in order, you are free to start testing!

Keep Reading ›

How to send email in asp net C# with example? ›

SmtpClient client = new SmtpClient("smtp.gmail.com", 587); C# Copy.
Credentials = new System. Net. NetworkCredential("username", "password"); C# Copy.
EnableSsl = true; C# Copy.
Send(message); C# Copy.

Feb 1, 2024

Get More Info ›

What is the best way to send mail in C#? ›

The most common way of sending emails from your C# application is by using a Simple Mail Transfer Protocol (SMTP) server. But, as C# is not able to communicate with and instruct an SMTP host server on its own, you will need the . NET framework.

How to validate email in asp net Core? ›

ASP.NET Core offers various approaches to implement email validation. One common method is using Data Annotations, such as the [EmailAddress] attribute, to decorate your model properties. By applying [EmailAddress] to the Email property, you instruct ASP.NET Core to validate the input as an email address.

Show Me More ›

How to send email in C# .NET using SMTP and SendGrid? ›

How to send SMTP emails in C# . NET using SendGrid

Verify your email sender in the SendGrid app and create an API key.
Connect to SendGrid's SMTP server at smtp.sendgrid.net and use port 587.
Authenticate against the SMTP server using "apikey" as the username and the actual API key as the password.

More items...

Feb 22, 2022

How do I add an email template to my email? ›

Use a Template

In the New Message, click More options. Click Templates. Click the template you wish to use. Add or edit the new message as needed.

Keep Reading ›

How to send email in .NET Core 6? ›

. NET 6.0 - Send an Email via SMTP with MailKit

Install MailKit via NuGet. .NET Core CLI: dotnet add package MailKit. ...
Send an HTML email in . NET 6.0. ...
Send a plain text email in .NET 6.0. ...
Send SMTP email with Gmail, Hotmail, Office 365 or AWS SES. ...
Wrap it up in an Email Service.

Mar 11, 2022

Read On ›

How do I send an email using SendGrid in .NET core? ›

Then follow these steps:

Log in to your SendGrid account.
Select Settings -> Sender Authentication.
Select “Single Sender Verification.”
Click on the “Get Started” button.
Create a Sender by specifying the sender details.
Click on the “Verify Single Sender” button.

More items...

Mar 2, 2023

How do I create an email template in eM client? ›

eM Client mail templates

In the Mail Templates section, click on the Mail Templates... button and then click New. Be sure to give the template a name, otherwise, you won't be able to save it. Then you may pick the color , font, set a background image, add any attachments, and write up a template mail.

Read The Full Story ›