Sending Email By Using Email Templates In ASP.NET WebForm

Manoj Kalla
7y
3.6k
0
5

Article

In this article you will learn the following things,

What are Email Templates?
How to send email through Asp.Net WebForm?
Step By Step Implementation of Sending Email By Email Templates in Asp.Net WebFom.

What are Email Templates?

Email templates is a predefined body of text of email messages. Sending email is just about filling in the blank fields.

Example

NewUserName is a blank field you'll replace with actual data like “Ashish / Suhana Kalla”.

Dear [NewUserName] (this text in email templates)

Dear Ashish / Suhana Kalla (While sending system will replace the NewUserName with Actual User Name)

How to send email through Asp.Net WebForm?

We can send Email through coding that's codebehind. For this the following things are required :

Email Account: In this article we had used GMAIL accounts.
Email Account SMTP Detail.
Code of Email Sending: In dot net framework there are two namespaces, System.Net, System.Net.Mail reuired.
1. using System.Net;
2. using System.Net.Mail;

System.Net namespace used for set NetworkCredential in below image you can see.

ASP.NET WebForm

System.Net.Mail namespace used for classes called “MailMessage” and “SMTP”

In image you can see MailMessage is dedicated to sending email messages using SMTP client.

ASP.NET WebForm

In image you can see detail of SmtpClient.

ASP.NET WebForm

Code Explanation

Base class for sending email
MailMessage _mailmsg = new MailMessage();
Make TRUE because our body text is html
_mailmsg.IsBodyHtml = true;
Set From Email ID
_mailmsg.From = new MailAddress(emailSender);
Set To Email ID
_mailmsg.To.Add(txtUserName.Text.ToString());
Set Subject
_mailmsg.Subject = subject;
Set Body Text of Email
_mailmsg.Body = MailText;
Now set your SMTP
SmtpClient _smtp = new SmtpClient();
Set HOST server SMTP detail
_smtp.Host = emailSenderHost;
Set PORT number of SMTP
_smtp.Port = emailSenderPort;
Set SSL --> True / False
_smtp.EnableSsl = emailIsSSL;
Set Sender UserEmailID, Password
NetworkCredential _network = new NetworkCredential(emailSender, emailSenderPassword);
_smtp.Credentials = _network;
Send Method will send your MailMessage create above.
_smtp.Send(_mailmsg);

As per best practice in this article the following things are fetched from Web.Config file:

Sender Email ID
Password
SMTP server detail.
Port Number
IsSSL value.

For complete code you can see Signup.aspx.cs file.

Step By Step Implementation of Sending Email By Email Templates in Asp.Net WebFom

For this task we go through the following 7 steps,

Create Asp.Net Empty Web Site Project.
Insert New HTML File named ”SignUp.html”
Write the content for SignUp.html (Code of HTML)
Free webmail Gmail / Yahoo account and SMTP Settings required.
Config updation with SMTP setting.
Insert an new WebForm file.
Write code to shoot email using email template called Signup.html.

Now we go step by step as per the above points in a simple way, that's easier to learn.

Start Visual Studio, I am using Visual Studio 2015 Community Edition.

STEP 1

Create a new Project by clicking on FILE --> WebSite

In below image you see I had used Asp.Net Empty Web Site

ASP.NET WebForm

STEP 2

Create a new folder called “EmailTemplates” you create a new folder by right click on project title in Solution explorer.

By right clicking you can see the below give image; select NEW FOLDER; after that one folder comes your project; rename it to “EmailTemplates”.

After taking the above step your solution explorer looks like this,

ASP.NET WebForm

Now select EmailTemplates folder and insert a new HTML file inside folder. To insert a new html file you have to again right click on project and select Add New Item.

ASP.NET WebForm

Select HTML Page and give name “SignUp.html”.

ASP.NET WebForm

In SignUp.Html file we will set basic body text of email which shoots / executes while new user registers / signs up on portal / site.

In signup email we will send user’s User Name.

Code in SignUp.html

<!DOCTYPE html>
<html>
<head>
<title></title>
<meta charset="utf-8" />
<style>
table, th, td {
border: 1px solid black;
}
</style>
</head>
<body>
<br />
<table width="50%">
<tr>
<td align="center" style="background-color:yellow">
<span style="font-size:25px;"> Welcome To C# Corner </span>
<br />
<br />
</td>
</tr>
<tr align="center">
<td>
<br />
<br />
Dear [newusername]
<br />
<br />
Thank you for registering with us!
<br />
<a href="http://www.c-sharpcorner.com">
Click here to Login
</a>
Regards,
<br />
<br />
</td>
</tr>
<tr>
<td align="center" style="background-color:yellow">
<br />
<br />
<span style="font-size:15px;text-decoration:underline"> Share your knowledge </span>
<br />
<span style="font-size:20px;"> <i>If you have knowledge, let others light their candles in it - Margaret Fuller </span>
<br />
<br />
</td>
</tr>
</tr>
</table>
</body>
</html>

Email Template Output looks like,

STEP 3 Sending through Gmail Account

Email Account : <Your Gmail Account>
E.g.: [email protected]

Password: <Your Gmail Account Password>

SMTP Detail: smtp.gmail.com
(SMTP stand for Simple Mail Transfer Protocol)

Port Detail: 587

Note

If you want to send mail through shared hosting or other domains the above things are required.

STEP 4 - Updation of Web.Config file

As per best practice we should always store settings kind of things into Web.Config file.

Now we are going to store settings of gmail/yahoo account into web.config file.

Code in Web.Config file

<?xml version="1.0"?>
<!--
For more information on how to configure your ASP.NET application, please visit
http://go.microsoft.com/fwlink/?LinkId=169433
-->
<configuration>
<appSettings>
<add key="smtp" value="smtp.gmail.com"/>
<add key="portnumber" value="587"/>
<add key="username" value="[email protected]"/>
<add key="password" value="abc@123"/>
<add key="IsSSL" value="true"/>
</appSettings>
<system.web>
<compilation debug="true" targetFramework="4.5.2" />
<httpRuntime targetFramework="4.5.2" />
</system.web>
</configuration>

STEP 5

To insert a new web form file you have to again right click on project and select Add New Item.

Insert an new WebForm file named “Signup.aspx”

In signup.aspx there are only three(3) server side controls.

TextBox used for USER NAME.
TextBox used for PASSWORD.
Button used for SUBMIT

Code in Signup.aspx file

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Signup.aspx.cs" Inherits="Signup" %>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
<style type="text/css">
.auto-style1 {
height: 30px;
}
</style>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>New User (Signup)</h3>
<table>
<tr>
<td>User Name<br />
(Email ID)
</td>
<td>
<asp:TextBox ID="txtUserName" runat="server" Width="200px"></asp:TextBox>
</td>
</tr>
<tr>
<td>
<br />
Password
</td>
<td>
<br />
<asp:TextBox ID="txtPassword" runat="server" TextMode="Password" Width="200px"> </asp:TextBox>
</td>
</tr>
<tr>
<td colspan="2" class="auto-style1">
<asp:Button ID="btnSubmit" runat="server" Text="Register (Signup)" OnClick="btnSubmit_Click" />
</td>
</tr>
</table>
</div>
</form>
</body>
</html>

Code in Signup.aspx.cs file

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
//System.Net
using System.Net;
//System.Net.Mail namespace required to send mail.
using System.Net.Mail;
using System.Configuration;
using System.IO;
public partial class Signup : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
}
protected void btnSubmit_Click(object sender, EventArgs e)
{
//Fetching Settings from WEB.CONFIG file.
string emailSender = ConfigurationManager.AppSettings["emailsender"].ToString();
string emailSenderPassword = ConfigurationManager.AppSettings["password"].ToString();
string emailSenderHost = ConfigurationManager.AppSettings["smtpserver"].ToString();
int emailSenderPort = Convert.ToInt16(ConfigurationManager.AppSettings["portnumber"]);
Boolean emailIsSSL = Convert.ToBoolean(ConfigurationManager.AppSettings["IsSSL"]);
//Fetching Email Body Text from EmailTemplate File.
string FilePath = "D:\\MBK\\SendEmailByEmailTemplate\\EmailTemplates\\SignUp.html";
StreamReader str = new StreamReader(FilePath);
string MailText = str.ReadToEnd();
str.Close();
//Repalce [newusername] = signup user name
MailText = MailText.Replace("[newusername]", txtUserName.Text.Trim());
string subject = "Welcome to CSharpCorner.Com";
//Base class for sending email
MailMessage _mailmsg = new MailMessage();
//Make TRUE because our body text is html
_mailmsg.IsBodyHtml = true;
//Set From Email ID
_mailmsg.From = new MailAddress(emailSender);
//Set To Email ID
_mailmsg.To.Add(txtUserName.Text.ToString());
//Set Subject
_mailmsg.Subject = subject;
//Set Body Text of Email
_mailmsg.Body = MailText;
//Now set your SMTP
SmtpClient _smtp = new SmtpClient();
//Set HOST server SMTP detail
_smtp.Host = emailSenderHost;
//Set PORT number of SMTP
_smtp.Port = emailSenderPort;
//Set SSL --> True / False
_smtp.EnableSsl = emailIsSSL;
//Set Sender UserEmailID, Password
NetworkCredential _network = new NetworkCredential(emailSender, emailSenderPassword);
_smtp.Credentials = _network;
//Send Method will send your MailMessage create above.
_smtp.Send(_mailmsg);
}
}