Sending E-Mails using ASP.NET

原创 2004年10月30日 19:22:00

by Faisal Khan.

Overview

In this tutorial we will learn how to send e-mails of both text and HTML formats using classes of System.Web.Mail namespace.

Before delving in to the source code, I'll briefly explain the MailMessage and SmtpMail classes which we'll be using to send e-mails.

System.Web.Mail.MailMessage

An object of this class represents a single e-mail message. Properties of this class are listed below :

Properties of MailMessage
Properties of MailMessage

To use this class, we create a new object using the empty constructor, set some of it's properties and then send the message using static method of SmtpMail class's Send() method.

	MailMessage mail = new MailMessage();

		mail.To = "receivers@email.address";
		mail.From = "senders@email.address";
		mail.BodyFormat = MailFormat.Text;
		mail.Subject = "Subject of this Email";
		mail.Body = "Body of this message.";

	SmtpMail.Send(mail);

All the code required to create and send a MailMessage object has been shown above. If you've understood this code then you don't need to go any further. Just change the values to suite your needs. In the rest of this article we will create a sendMail.aspx page which will make use of the above code.

High-end commercial email component :

i. AspEmail : Most feature-rich mailing component. Supports message queueing, embedded images, secure mail, authentication. Read more.

System.Web.Mail.SmtpMail

This class is used to *send* e-mails ( MailMessages ) using SMTP protocol. All we are interested as far as this tutorial is concerned are the two static methods ( Send() ) it provides. You just use the static method, provide a valid MailMessage object as the argument, and send it!.

Properties And Methods of SmtpMail
Properties And Methods of SmtpMail

sendMail.aspx

It is time now that we create a simple ASP.NET page which provides a form to you, you enter the values and hit the "send" button to send the message. A confirmation message is then displayed.

Create a new .aspx page and save it as sendMail.aspx in a folder accessible by your server. Now copy and paste the following code in it :

<%@ Page Language="C#" %>
<%@ Import NameSpace="System.Web.Mail" %>

<script runat="server">
	protected void Page_Load(Object Sender, EventArgs e) {
		if(!Page.IsPostBack)
			Message.Text = "Sending E-Mail using ASP.NET";
	}

	protected void Send_Email(Object Sender, EventArgs e) {
		MailMessage mail = new MailMessage();

			mail.To = Request.Form["to"];
			mail.From = Request.Form["from"];

			if(Request.Form["format"].Equals("text"))
				mail.BodyFormat = MailFormat.Text;
			else
				mail.BodyFormat = MailFormat.Html;

			mail.Subject = Request.Form["subject"];
			mail.Body = Request.Form["body"];

		SmtpMail.Send(mail);
		Response.Flush();

		Message.Text = "Message Sent...<br><br>" + 
				"<a href=/"sendMail.aspx/">Go Back</a>";
	}
</script>
<html>
<head>
	<title>Sending E-Mails using ASP.NET ( Part I )</title>
	<style>
	a { font-size:8pt; font-family:Tahoma; font-weight:normal;
		color:maroon; }
	</style>
	<link rel="stylesheet" href="css/demostyle.css">
</head>
<body bgcolor="white">

<p align="center" class="title">
	<asp:label id="Message" runat="server" />
</p>

<% if(!Page.IsPostBack) { %>
	<p align="center">All fields are required.</p>

<form method="post" runat="server">	
<table width="80%" border="0" align="center" cellpadding="2" cellspacing="2">
	<tr>
		<td width="20%" align="right">From : </td>
		<td><input type="text" name="from"></td>
	</tr>
	<tr>
		<td align="right">To : </td>
		<td><input type="text" name="to"></td>
	</tr>
	<tr>
		<td align="right">MailFormat : </td>
		<td>
			<select name="format">
				<option value="text">Text</option>
				<option value="html">HTML</option>
			</select>
		</td>
	</tr>
	<tr>
		<td align="right">Subject : </td>
		<td><input type="text" name="subject" style="width:400;"></td>
	</tr>
	<tr>
		<td valign="top" align="right">Body : </td>
		<td>
		<textarea cols="5" rows="10" name="body" style="width:400;">
		</textarea></td>
	</tr>
	<tr>
		<td> </td>
		<td>
		<input type="submit" OnServerClick="Send_Email" runat="server" 
		class="submit" value=" " /> Send Email!
		</td>
	</tr>
</table>
</form>
<% } %>

</body>
</html>
Explanation

The first line tells that we will be using C# to code the ASP.NET page. Second line is an Import directive which tells the the C# compiler that we are making use of classes from System.Web.Mail namespace.

<%@ Page Language="C#" %>
<%@ Import NameSpace="System.Web.Mail" %>
Explanation of sendMail.aspx code

Then we enter the script block. Notice that this script block has a "runat" attribute with a value of "server". This means that the code inside this block is meant to run on the server-side. In this code block we have two methods; Page_Load() and Send_Email().

<script runat="server">

Page_Load() is actually an event which is raised when the ASP.NET page is loaded. This method is present in all ASP.NET pages, to make use of this event, all you have to do is to provide some implementation of this method ( i.e. put some code in this method ). Here in this method we are checking for the IsPostBack property of Page object. This property like it's name suggests gives a "true" value when the page has been posted back i.e. the user has pressed the submit button on the Form to post the page back.

So this Page.IsPostBack property is very useful. It allows us to put both the Form and Form handler code ( when the Form is posted back ) on the same page. What we do here is to check this property, and if user has not posted the page back then set the value of Message control to the provided one. What is a Message control? we'll see later.

protected void Page_Load(Object Sender, EventArgs e) {
	if(!Page.IsPostBack)
		Message.Text = "Sending E-Mail using ASP.NET ( Part I )";
}

The second method; Send_Email() is our own event method which is called when user presses the submit button on the Form. In this method we use the same code we learned on the first page to create a MailMessage object and then send it using SmtpMail class's Send() method.

Once done, we set the value of Message control to a confirmation message and a link back to the Form.

	protected void Send_Email(Object Sender, EventArgs e) {
		MailMessage mail = new MailMessage();

			mail.To = Request.Form["to"];
			mail.From = Request.Form["from"];

			if(Request.Form["format"].Equals("text"))
				mail.BodyFormat = MailFormat.Text;
			else
				mail.BodyFormat = MailFormat.Html;

			mail.Subject = Request.Form["subject"];
			mail.Body = Request.Form["body"];

		SmtpMail.Send(mail);
		Response.Flush();

		Message.Text = "Message Sent...<br><br>" + 
				"<a href=/"sendMail.aspx/">Go Back</a>";
	}

Then we close the script code block.

</script>

We have been talking of Message control but where is it and what is a control? Well, a control is a server-side component which does some thing useful. The Message control is of type ASP:Label and the only reason we are using it is that we can set it's value using logic on the server-side. We will learn more about controls in some other article later.

We declare ASP:Label control on the top of the page. Notice the value of "id" attribute? this is why we have been using Message handle to set it's value.

<p align="center" class="title">
	<asp:label id="Message" runat="server" />
</p>

Next we again look for Page.IsPostBack property and if the page has not been posted back then show the e-mail Form to the user.

<% if(!Page.IsPostBack) { %>
	... all Form code here
<% } %>

One last thing interesting is that we said that our Send_Email() method is an event method raised on the server-side when the user presses the submit button, how? we did that by putting yet another type of server-side control. In the submit button code we put two new attributes, "runat=server" to make it a control and "OnServerClick". This "OnServerClick" event is the key and it's value is our Send_Email() method. So our Send_Email() method will be called every time user presses this submit button.

	<input type="submit" OnServerClick="Send_Email" runat="server" 
		class="submit" value="? /> Send Email!

Don't worry if you cannot swallow this server-side control and event model. We will study it in detail some other time. For now let's move forward to the next page where we run this sendMail.aspx page and see the results.

Running the sendMail.aspx page
Ok, it is time to run the sendMail.aspx page. You can use a URL like http://localhost/net/sendMail.aspx on your system, provided where you have placed the sendMail.aspx page. On my system the sendMail.aspx page looked like following :

sendMail.aspx
sendMail.aspx

Now enter your valid email address in the "From" and "To" fields, any text in the subject and body fields and hit the "Send Email!" button on the sendMail.aspx page on your system. If all goes well you should see a confirmation message like I did :

Confirmation Message
sendMail.aspx - Confirmation Message

If you don't get a confirmation message and an error message then most probably SMTP service is not enabled on your system. You can then provide your own SMTP server ( provided by your ISP ) and change the SmtpMail.Send(mail) line in the Send_Email() method to the one below :

	SmtpMail.SmtpServer = "smtp.yourisp.com";
	SmtpMail.Send(mail);

And this time you should be able to send your e-mail. Well this is it for this tutorial, one thing to keep in mind is to provide valid email address in From and To fields and non-empty values in subject and body fields. If you don't do that you'll get a nasty ASP.NET error message on your face. This is why I have called this tutorial Part I, because there is no validation for the values entered by the user. Hopefully in Part II we'll learn how to handle a case when user didn't enter a value and pressed the "Send Email!" button or he provided an invalid destination e-mail address.

版权声明:本文为博主原创文章,未经博主允许不得转载。

[ZT]Sending E-Mails using ASP.NET

Sending E-Mails using ASP.NETby Faisal Khan.OverviewIn this tutorial we will learn how to send e-mai...
  • BubbleKittyII
  • BubbleKittyII
  • 2005年02月03日 21:05
  • 1499

[ZT]Sending Mass E-Mails using ASP.NET

Sending Mass E-Mails using ASP.NETby Faisal Khan.OverviewThis article is part II of a series of arti...
  • BubbleKittyII
  • BubbleKittyII
  • 2005年02月03日 21:13
  • 1891

android自动化工具之--Monkey log分析说明

运行命令: adb shell monkey -p com.crazyhornets.MyHokageAndroidZSY -v -v -v 20 -- throttle 1000 Log: :...
  • automationwei
  • automationwei
  • 2015年09月07日 15:17
  • 730

Sending E-mail using C#

http://stackoverflow.com/questions/449887/sending-e-mail-using-c-sharp using System.Net; using ...
  • SalmonellaVaccine
  • SalmonellaVaccine
  • 2014年06月25日 05:05
  • 917

Using .NET and Excel 2003 To Validate E-Mails

function SetFormAction7() { newLocation = "http://hardwarecentral.dealtime.com/xKW-" + document.frm...
  • waterboy
  • waterboy
  • 2004年09月09日 06:06
  • 1022

asp.net常用的命名空间及含义

using System;//引入核心命名空间,是一切类的基础 using System.Collections.Generic;//引入集合类命名空间,能够使用泛型类等集合类 using Sys...
  • yhd0916
  • yhd0916
  • 2017年01月11日 16:07
  • 174

Asp.net 类中使用中括号([......])的作用

 对于类似于这样的说明标记[System.ComponentModel.DataObjectMethodAttribute(System.ComponentModel.DataObjectMethod...
  • zhang_0896
  • zhang_0896
  • 2008年10月14日 12:42
  • 1487

mysql sending data的状态导致数据库很慢及无法DDL 操作

sending data状态表示两种情况,一种是mysql已经查询了数据,正在发给客户端;另一种情况是,mysql已经知道某些数据需要去什么地方读取,正在从数据文件中读取; 说明:最近帮忙定位一个m...
  • eagle89
  • eagle89
  • 2017年09月25日 16:08
  • 382

C# 发送邮件 Failure sending mail

用using System.Net.Mail发送 ,微软已公布解决方法
  • dongchunlei945
  • dongchunlei945
  • 2014年07月11日 17:05
  • 1050

Mysql sending data 问题

最近公司服务器上总是出现Mysql卡死的问题, 用 show processlist 命令打印出很多进程卡死在sending data 状态。一开始为了快速的回复正常状态, 我尝试使用了如下的命令: ...
  • u012633802
  • u012633802
  • 2013年11月14日 04:21
  • 2447
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Sending E-Mails using ASP.NET
举报原因:
原因补充:

(最多只允许输入30个字)