Send Email with example in ASPNet MVC

In this article I will explain with an example, how to send email in ASP.Net MVC.

Note: For beginners in ASP.Net MVC, please refer my article ASP.Net MVC Hello World Tutorial with Sample Program example.

Mail Server Settings in Web.Config file

The following Mail Server settings need to be saved in the Web.Config file.

Note: It is necessary to use the sender’s email address credentials while defining the Gmail SMTP Server Credentials as Gmail the sender’s email address must be same as the Gmail Username specified in credentials.

<system.net>

<network

host="smtp.gmail.com"

port="587"

enableSsl="true"

userName="sender@gmail.com"

password="GMAILor2STEP-PASSWORD"

defaultCredentials="true" />

</smtp>

</mailSettings>

</system.net>

Sending Email using Gmail SMTP

MailMessage class properties

Following are the required properties of the MailMessage 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.

IsBodyHtml – Specify whether body contains text or HTML mark up.

Attachments – Attachments. (If any)

ReplyTo – ReplyTo Email address.

SMTP class properties

Following are the properties of the SMTP class.

Host – SMTP Server URL. (Gmail: smtp.gmail.com)

EnableSsl – Specify whether your host accepts SSL Connections. (Gmail: True)

UseDefaultCredentials – Set to True in order to allow authentication based on the Credentials of the Account used to send emails.

Credentials – Valid login credentials for the SMTP server. (Gmail: email address and password)

Port – Port Number of the SMTP server. (Gmail: 587)

Model

The Model class consists of the following properties.

public class EmailModel

{

public string To { get; set; }

public string Subject { get; set; }

public string Body { get; set; }

}

Namespaces

You will need to import the following namespaces.

using System.Net;

using System.Net.Mail;

using System.Configuration;

using System.Net.Configuration;

Controller

The Controller consists of following Action methods.

Action method for handling GET operation

Inside this Action method, simply the View is returned.

Action method for handling POST operation

Inside this Action method, the posted values are captured through the EmailModel class object.

All the fetched values are set into an object of the MailMessage class object.

Setting Body of Email

The Body of the email is Text (Non HTML) hence the IsBodyHtml property of the MailMessage class object is set to FALSE.

Sending Email

Then, an object of the SmtpClient class is created and the values of Host, Port, DefaultCredentials and EnableSsl are fetched from the SMTP section of the Web.Config file and are set in respective properties of the SmtpClient class object.

And Username and Password values are passed as parameter to NetworkCredential class from the SMTP section of the Web.Config file.

Finally, the email is being sent using Send method of SmtpClient class object and a success message is set to a ViewBag object.

public class HomeController : Controller

{

// GET: Home

public ActionResult Index()

{

return View();

}

[HttpPost]

public ActionResult Index(EmailModel model)

{

//Read SMTP section from Web.Config.

SmtpSection smtpSection = (SmtpSection)ConfigurationManager.GetSection("system.net/mailSettings/smtp");

using (MailMessage mm = new MailMessage(smtpSection.From, model.To))

{

mm.Subject = model.Subject;

mm.Body = model.Body;

mm.IsBodyHtml = false;

using (SmtpClient smtp = new SmtpClient())

{

smtp.Host = smtpSection.Network.Host;

smtp.EnableSsl = smtpSection.Network.EnableSsl;

NetworkCredential networkCred = new NetworkCredential(smtpSection.Network.UserName, smtpSection.Network.Password);

smtp.UseDefaultCredentials = smtpSection.Network.DefaultCredentials;

smtp.Credentials = networkCred;

smtp.Port = smtpSection.Network.Port;

smtp.Send(mm);

}

ViewBag.Message = "Email sent.";

return View();

}

View

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, FileUpload element in ASP.Net MVC, please refer following articles.

ASP.Net MVC: Html.TextBoxFor and Html.DropDownListFor example

ASP.Net MVC: Create TextArea using HTML Helper

When the Submit Button is clicked, the Form gets submitted and the Model object is sent to the Controller.

Note: For more details in Form Submission in ASP.Net MVC, please refer ASP.Net MVC: Form Submit (Post) example.

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 Read_Mail_Settings_Web.Config_MVC.Models.EmailModel

Layout = null;

}

<!DOCTYPE html>

<html>

<head>

<title>Index</title>

</head>

<body>

@using (Html.BeginForm("Index", "Home", FormMethod.Post))

{

<tr>

<td>@Html.TextBoxFor(m => m.To)</td>

</tr>

<tr>

</tr>

<tr>

<td>Subject:</td>

<td>@Html.TextBoxFor(m => m.Subject)</td>

</tr>

<tr>

</tr>

<tr>

<td>@Html.TextAreaFor(m => m.Body, new { @rows = 10, @cols = 50 })</td>

</tr>

<tr>

</tr>

<tr>

</tr>

</table>

}

@if (ViewBag.Message != null)

{

window.onload = function () {

alert("@ViewBag.Message");

};

</script>

}

</body>

</html>

Possible Errors

The following error occurs when you try to send email using Gmail credentials in your application.

The SMTP server requires a secure connection or the client was not authenticated. The server response was: 5.5.1 Authentication Required. Learn more at

Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code.

Exception Details: System.Net.Mail.SmtpException: The SMTP server requires a secure connection or the client was not authenticated. The server response was: 5.5.1 Authentication Required. Learn more at

Solution

The solution to this problem is explained in this article, GMAIL Error: The SMTP server requires a secure connection or the client was not authenticated.

Screenshots

Email Form