ASP.NET 2.0中发送电子邮件剖析
2008-04-07 21:23
597 查看
ASP.NET 2.0中发送电子邮件剖析之一
2006-09-23 07:00 作者: 朱先忠编译 出处: 天极开发 责任编辑:方舟
本文关键词: ASP.NET 发送 电子邮件
一、简介如今,电子邮件已经成为一种无所不在、异步通知和分布式的消息系统。存在许多web开发场所;其中,服务器端代码都需要生成一个电子邮件并且把它发送给指定的接收者。该电子邮件可以被发送给网点中的一些用户,通知他们有关于他们的新建用户帐户,提醒他们忘记的口令,或以邮件形式提交给他们一个清单。当然,这也可以是针对web开发者或站点管理员,提供给他们有关一个刚刚公开的未处理的异常或用户回馈的消息。
幸好,ASP.NET使得发送电子邮件非常轻松。.NET框架版本1.x在System.Web.Mail类中包括了许多类,它们允许以编程方式通过短短的几行代码来发送一个电子邮件。尽管这个命名空间和这些类仍然存在于.NET框架2.0版本中,但是它们已经过时,你可以在System.Net.Mail命名空间中找到新的与邮件支持相关的类。
在本文中,让我们来一起探讨System.Net.Mail命名空间中的相关类,并且分析如何从一个ASP.NET 2.0页面的code-behind类中发送一个电子邮件。我们还要在Web.config中指定中继服务器消息以及如何把这个消息应用于一些内置ASP.NET服务器控件中以便实现发送电子邮件(例如当一个用户创建一个帐户或需要一个口令提示器/重置器时)。
二、探讨System.Net.Mail命名空间中的类
在System.Net.Mail命名空间中共有16个不同的类,它们都与把电子邮件发送到一个指定的简单的邮件传输协议(SMTP)服务器以便进一步提交有关。在这个命名空间中有两个核心类是:
· MailMessage:描述一个电子邮件消息;它拥有From,To,Subject,Body等属性;
· SmtpClient:把一个指定的MailMessage实例发送到一个指定的SMTP服务器。
典型地,当你从一个ASP.NET 2.0页面中发送电子邮件时,你要:
1. 创建一个MailMessage对象;
2. 赋给它属性;
3. 创建一个SmtpClient类实例;
4. 指定关于使用该SMTP服务器的细节(如果它们没有在Web.config中指定);
5. 经由SmtpClient对象的Send方法发送该MailMessage。
其中,上面的第1步和第2步可以被略过,因为SmtpClient类的Send方法能够接收一个MailMessage对象或接收四个字符串(分别描述电子邮件消息内容的from,to,subject和body部分)。
System.Net.Mail命名空间中的其它类还提供了更高级的电子邮件功能。例如,这些类能够用于在一个电子邮件消息中添加附件,把对象嵌入到一个电子邮件,指定SMTP服务器认证消息等;还有一些Exception的派生类用于处理SMTP特定的异常。我们会在以后的文章中来讨论这些其它类的更高级的使用情形。
三、提供有关SMTP服务器的详细信息
当从Outlook或GMail中把一个电子邮件发送给一个朋友时,该电子邮件程序使用一个中继服务器建立一个连接并且发送该电子邮件消息的内容(连同其它一些消息,例如电子邮件创建日期,电子邮件格式(文本或HTML,等等),接收者,等等)。中继服务器接收该消息,然后连接到接收者的SMTP服务器并且发送该消息。一旦该消息被提交,接收者就能够(稍后)使用一种不同的协议(例如IMAP或POP3)来提取该消息。
因此,为了从一个ASP.NET页面中发送一个电子邮件,我们需要提供给SmtpClient类关于该中继服务器的消息。借助于中继服务器的主机名,你能够指定下列信息:相应的端口号(典型地使用端口25),当把你的电子邮件消息内容连接到中继服务器时是否使用SSL,以及认证证书(如果必要的话)等。作为选择,如果你可以在你的web服务器上安装一个本地SMTP服务,它可以周期性地监视一个特别的"drop-off"目录,发送出现在那个目录中的任何消息。你能够配置是否该SmtpClient类把它的电子邮件消息传送给一个单独的中继服务器或是否能通过DeliveryMethod属性把该邮件投入到一个指定的检出目录下。
SmtpClient类使用的中继服务器信息能够以编程方式通过SmtpClient类的属性指定,也可以被集中在Web.config文件中。为了使用Web.config方法,你可以在<configuration>元素内添加一个<system.net>元素。然后,添加一个包含一个<smtp>元素(其设置是在它的<network>子元素中指定的)的<mailSettings>元素。请参考如下的代码:
<configuration> <!-把电子邮件设置添加到<system.net>元素--> <system.net> <mailSettings> <smtp> <network host="relayServerHostname" port="portNumber" userName="username" password="password" /> </smtp> </mailSettings> </system.net> <system.web> ... </system.web> </configuration> |
只有SmtpClient属性的一个子集能够通过Web.config中的设置指定。为了定制其它的SmtpClient属性(例如EnableSsl,Timeout,等等),你可以在发送电子邮件时以编程方式设置它们。
四、通过回馈Web页面发送管理员电子邮件
为了说明使用MailMessage和SmtpClient类来实现发送一个电子邮件,我已经创建了一个简单的回馈页面示例。在这个页面中,用户被提示输入其电子邮件地址,他们的回馈主题和相应的回馈内容。
<table border="0"> <tr> <td> <b>Your Email:</b> </td> <td> <asp:TextBox runat="server" ID="UsersEmail" Columns="30"></asp:TextBox> </td> </tr> <tr> <td> <b>Subject:</b> </td> <td> <asp:TextBox runat="server" ID="Subject" Columns="30"> </asp:TextBox> </td> </tr> <tr> <td colspan="2"> <b>Body:</b> <br /> <asp:TextBox runat="server" ID="Body" TextMode="MultiLine" Columns="55" Rows="10"> </asp:TextBox> </td> </tr> <tr> <td colspan="2" align="center"> <asp:Button runat="server" ID="SendEmail" Text="Send Feedback" /> </td> </tr> </table> |
Protected Sub SendEmail_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles SendEmail.Click '!!!把这个值更新为你的电子邮件地址 Const ToAddress As String = "you@youremail.com" '(1)创建MailMessage实例 Dim mm As New MailMessage(UsersEmail.Text, ToAddress) '(2)属性MailMessage赋值 mm.Subject = Subject.Text mm.Body = Body.Text mm.IsBodyHtml = False '(3)创建SmtpClient对象 Dim smtp As New SmtpClient '(4)发送MailMessage(将使用Web.config设置) smtp.Send(mm) End Sub |
通过进一步结合来自于ASP.NET 1.x的其它改进功能,ASP.NET 2.0中的电子邮件发送能力被进一步更新并且移动到一个新的命名空间-System.Net.Mail。在ASP.NET 2.0中,中继服务器设置能够容易地脱离ASP.NET代码,而移动到Web.config文件中,正如我们在这个示例所看到的。而且,还有对中继服务器认证更好的支持。在下篇文章中,我们将探讨更高级电子邮件使用情况,例如构造HTML格式的电子邮件,发送附件,把对象嵌入到电子邮件内,处理与SMTP/中继服务器相关的异常,等等。
ASP.NET 2.0发送电子邮件全面剖析之二
2006-09-24 08:00 作者: 朱先忠编译 出处: 天极开发 责任编辑:方舟一、简介
在上篇中我们详细分析过,.NET框架2.0版本提供了一个新的命名空间(System.Net.Mail)和一些发送电子邮件的新类(注意:.NET框架1.x版本中提供的命名空间System.Web.Mail及相关的类仍然可以使用,以实现向后兼容性)。而且,我们还详细分析过如何使用System.Net.Mail命名空间中的MailMessage和SmtpClient类来发送简单的普通文本格式的电子邮件消息。
本篇将讨论与电子邮件相关的更高级的选项。我们要分析如何发送HTML格式的电子邮件,如何包括附件,以及当发送一个电子邮件时如何优雅地处理SMTP异常(例如无效的中继服务器凭证或如果该中继服务器处于离线状态)。
本文假定你已经熟悉从一个ASP.NET 2.0 web页面发送简单的普通文本电子邮件;否则的话,请首先阅读本系列文章中的上篇。
二、发送HTML格式的电子邮件
在ASP.NET 2.0中发送电子邮件时,我们已经看到如何发送普通文本电子邮件,这是通过把电子邮件内容赋给MailMessage类的Body属性实现的。其实,为了发送HTM格式的电子邮件,我们只要简单地把Body属性设置为要发送的HTML内容,然后把MailMessage类的IsBodyHtml属性设置为True即可。
为了演示如何发送一个HTML格式的消息,我创建了一个示例,其名字为HtmlEmail.aspx。代码如下:
'(1)创建MailMessage实例 Dim mm As New MailMessage(FromEmailAddress, ToEmailAddress) '(2)赋值MailMessage的属性 mm.Subject = "HTML-Formatted Email Demo Using the IsBodyHtml Property" mm.Body = "<h2>This is an HTML-Formatted Email Send Using the <code>IsBodyHtml</code> Property</h2><p>Isn't HTML <em>neat</em>?</p><p>You can make all sorts of <span style=""color:red;font-weight:bold;"">pretty colors!!</span>.</p>" mm.IsBodyHtml = True '(3) 创建SmtpClient对象 Dim smtp As New SmtpClient '(4)发送MailMessage (将使用Web.config设置) smtp.Send(mm) |
x-sender: ToEmailAddress x-receiver: FromEmailAddress mime-version: 1.0 from: FromEmailAddress to: ToEmailAddress date: 25 Jul 2006 15:06:44 -0700 subject: HTML-Formatted Email Demo Using the IsBodyHtml Property content-type: text/html; charset=us-ascii content-transfer-encoding: quoted-printable <h2>This is an HTML-Formatted Email Send Using the <code>IsBodyHtml</code>= Property</h2><p>Isn't HTML <em>neat</em>?</p><p>You can make all sorts= of <span style=3D"color:red;font-weight:bold;">pretty colors!!</span>.</p> |
观察通过SmtpClient类发送到中继服务器的实际电子邮件内容是很有趣的(如上面这样),对不对?在上篇中,我们讨论了如何配置SmtpClient类以把电子邮件发送到一个中继服务器或者把它投入到一个指定的目录下。使用第二个选择时,我们能够探讨实际的电子邮件内容。你可以检查本文下载代码中的Web.config文件。其中,有一个加了注释的<smtp>元素,它展示了如何配置该SmtpClient类以便把电子邮件的内容复制到一个指定的目录。
该电子邮件客户端(假定它支持HTML格式的电子邮件)将在电子邮件内显示该HTML内容。如下图所示。
当发送HTML格式的电子邮件时,必须理解你在你的屏幕看到的HTML可能与你的接收者所看到的相当不同。大多数的电子邮件客户端都会"剔除"潜在危险的HTML内容(例如ActiveX控件等),许多用户都阻止JavaScript运行。
三、包括附件
MailMessage类有一个Attachments属性,它是一个Attachment类实例的集合。你能够把web服务器上的一个现有文件附加到电子邮件消息,或使附件的内容基于一个流(Stream)。为了展示使用附件发送电子邮件,我创建了一个演示程序,其中访问者能够填充一个回馈形式的表单以便把一个电子邮件发送到管理员。然而,这个回馈表单允许访问者从他们的计算机中选择一个文件以便依附到从该web页面发送的电子邮件中(这很象基于Web的电子邮件程序,如Hotmail,GMail,等等。当发送一个电子邮件时,它们允许你附加一个你的计算机中的文件)。
为了允许访问者从他们的计算机中附加一个文件,我们需要允许该用户把他们的计算机中的一个文件上载到web服务器。这可以使用FileUpload控件(这是ASP.NET2.0新添加的)来容易地实现。让我们来看一下这个演示程序中用于创建用户接口的声明性语法:
<table border="0"> <tr> <td><b>Your Email:</b></td> <td><asp:TextBox runat="server" ID="UsersEmail" Columns="30"></asp:TextBox></td> </tr> <tr> <td><b>File to Send:</b></td> <td> <asp:FileUpload ID="AttachmentFile" runat="server" /> </td> </tr> <tr> <td colspan="2"> <b>Body:</b><br /> <asp:TextBox runat="server" ID="Body" TextMode="MultiLine" Columns="55" Rows="10"></asp:TextBox> </td> </tr> <tr> <td colspan="2" align="center"> <asp:Button runat="server" ID="SendEmail" Text="Send Feedback" /> </td> </tr> </table> |
'确保已经上传一个文件 If String.IsNullOrEmpty(AttachmentFile.FileName) OrElse AttachmentFile.PostedFile Is Nothing Then Throw New ApplicationException("Egad, a file wasn't uploaded... you should probably use more graceful error handling than this, though...") End If '(1) 创建MailMessage实例 Dim mm As New MailMessage(FromEmailAddress, ToEmailAddress) '(2)赋值MailMessage的属性 mm.Subject = "Emailing an Uploaded File as an Attachment Demo" mm.Body = Body.Text mm.IsBodyHtml = False '附加文件 mm.Attachments.Add(New Attachment(AttachmentFile.PostedFile.InputStream, AttachmentFile.FileName)) '(3) 创建SmtpClient对象 Dim smtp As New SmtpClient '(4)发送MailMessage (将使用Web.config设置) smtp.Send(mm) |
当从一个ASP.NET页面发送电子邮件时,如果中继服务器关闭会发生什么?如果认证信息使用无效,又会怎么样呢?在出现一个SMTP错误时,SmtpClient类将抛出一个SmtpException异常。为了较好地处理这样的问题,我们可以在发送电子邮件的代码中加入异常处理代码。如果出现一个SmtpException,则我们能够显示一个更友好的信息性的错误提示。
在本文的下载内容中,我包括了一个演示,它允许访问者指定要使用的中继服务器以及认证信息。如果在试图发送一封电子邮件时存在一个错误,那么将显示一个客户端警告框,解释该问题。为了测试这一点,对于一个需要认证的中继服务器,你可以输入一个无效的中继服务器主机名或无效的凭证。
Try '(1)创建MailMessage实例 Dim mm As New MailMessage(FromEmailAddress, ToEmailAddress) '(2)赋值MailMessage的属性 mm.Subject = "Test Email... DO NOT PANIC!!!1!!!111!!" mm.Body = "This is a test message..." mm.IsBodyHtml = False '(3)创建SmtpClient对象 Dim smtp As New SmtpClient 'SMTP设置... smtp.Host = Hostname.Text If Not String.IsNullOrEmpty(Port.Text) Then smtp.Port = Convert.ToInt32(Port.Text) End If If Not String.IsNullOrEmpty(Username.Text) Then smtp.Credentials = New NetworkCredential(Username.Text, Password.Text) End If '(4)发送MailMessage(将使用Web.config设置) smtp.Send(mm) '显示一个客户端弹出窗口,解释该该邮件已经发出 ClientScript.RegisterStartupScript(Me.GetType(), "HiMom!", String.Format("alert('An test email has successfully been sent to {0}');", ToAddress.Replace("'", "/'")), True) Catch smtpEx As SmtpException '当发送电子邮件消息时发生了一个问题 ClientScript.RegisterStartupScript(Me.GetType(), "OhCrap", String.Format("alert('There was a problem in sending the email: {0}');", smtpEx.Message.Replace("'", "/'")), True) Catch generalEx As Exception '发生另外的一些问题 ClientScript.RegisterStartupScript(Me.GetType(), "OhCrap", String.Format("alert('There was a general problem: {0}');", generalEx.Message.Replace("'", "/'")), True) End Try |
在本文中,我们了解了如何发送HTML格式的电子邮件,使用附件发送电子邮件,以及优雅地处理在发送一个电子邮件消息中发生的异常。发送一个HTML格式的电子邮件就象在Body属性中指定HTML内容并且把IsBodyHtml属性为设置True一样地简单。真正的挑战在于,确保HTML内容能够在流行的电子邮件客户端按预期效果生成。为了把一个附件添加到一个电子邮件,只需要简单地添加一个Attachment对象到MailMessage的附件集合中。附件相应的数据可以来自于web服务器上的一个文件或来自于一个流。最后,为了处理SMTP级的异常,你可以添加使用SmtpClient类捕获SmtpException抛出的异常处理代码。
相关文章推荐
- ASP.NET 2.0中发送电子邮件剖析之二
- ASP.NET 2.0中发送电子邮件剖析之一
- ASP.NET 2.0发送电子邮件全面剖析之二
- ASP.NET 2.0发送电子邮件全面剖析之二
- ASP.NET 2.0中发送电子邮件剖析之一
- ASP.NET 2.0中发送电子邮件剖析之一
- ASP.NET 2.0发送电子邮件全面剖析之二
- ASP.NET 2.0发送电子邮件全面剖析之二
- ASP.NET 2.0中发送电子邮件剖析之一
- ASP.NET 2.0中发送电子邮件剖析之一
- ASP.NET 2.0中发送电子邮件剖析之一
- ASP.NET 2.0发送电子邮件全面剖析之二
- ASP.NET 2.0中发送电子邮件剖析之一 (转)
- ASP.NET 2.0发送电子邮件全面剖析之二
- ASP.NET 2.0中发送电子邮件
- ASP.NET 2.0发送电子邮件
- ASP.NET 2.0发送电子邮件中存在的问题
- ASP.NET 2.0发送电子邮件中存在的问题
- ASP.NET 2.0发送电子邮件中存在的问题
- ASP.NET 2.0发送电子邮件中存在的问题