System.Web.Mail - 2.0 快速入门示例

原文出自：http://www.systemwebmail.com/default.aspx

翻译：lzumcj

2 快速入门程序示例

System.Web.Mail 一系列示例，它支持设计来快速通知开发者了解在 .NET 中发送
email 的注释。快速入门示例被设计成简短的, 易于理解的 System.Web.Mail 示例。

重要的： 当测试这些示例时，总是确保：
1. 有 System.Web.dll 的引用集（reference set）。
2. 如果你用 C#, 确保 将"using System.Web.Mail;" 语句放在代码的顶端。或者如果你
用 VB.NET, 确保将"Imports System.Web.Mail"语句放在代码的顶端。
3. 设置正确的 FROM 和 TO 地址。
4. 设置 SmtpMail.SmtpServer 为有效的服务器， 它允许中继（relaying）你的
FROM email address 或者你发送 email 的 IP 地址。

2.1 如何发送简单的 email?

下例演示（demonstrates）了发送一个简单的文本（text） email。

[ C# ]

MailMessage mail = new MailMessage();
mail.To = "me@mycompany.com";
mail.From = "you@yourcompany.com";
mail.Subject = "this is a test email.";
mail.Body = "this is my test email body";
//your real server goes here SmtpMail.Send( mail );
SmtpMail.SmtpServer = "localhost";

[ VB.NET ]

Dim mail As New MailMessage()
mail.To = "me@mycompany.com"
mail.From = "you@yourcompany.com"
mail.Subject = "this is a test email."
mail.Body = "this is my test email body"
'your real server goes here SmtpMail.Send(mail)
SmtpMail.SmtpServer = "localhost"


2.2 如何发送简单的 Html email?

默认情况下, 用 System.Web.Mail 发送的 email 是纯文本（plain text）
格式。为格式化为 Html, 设置 MailMessage.BodyFormat 属性为
MailFormat.Html。

[ C# ]

MailMessage mail = new MailMessage();
mail.To = "me@mycompany.com";
mail.From = "you@yourcompany.com";
mail.Subject = "this is a test email.";
mail.BodyFormat = MailFormat.Html;
// 邮件格式 mail.Body = "this is my test email body.";
//your real server goes here SmtpMail.Send( mail );
SmtpMail.SmtpServer = "localhost";

[ VB.NET ]

Dim mail As New MailMessage()
mail.To = "me@mycompany.com"
mail.From = "you@yourcompany.com"
mail.Subject = "this is a test email."
mail.BodyFormat = MailFormat.Html
mail.Body = "this is my test email body."
'your real server goes here SmtpMail.Send(mail)
SmtpMail.SmtpServer = "localhost"
2.3 如何发送带附件（attachments）的 email?

为了发送带附件（attachments）的 email, ASP.NET 进程（process）
（或者 ASP.NET 模拟（impersonated）帐号）需要被允许读文件,
并且附加到 MailMessage 类（class）。

注意： 附件（Attachments）仅能从文件系统创建。System.Web.Mail
不支持直接从 strings, byte arrays, streams, 或者已上传（uploaded）
文件创建附件。 为了直接从这些类型创建附件（attachments）, 可以利用
aspNetEmail, 否则, 附件（attachment）内容必须首先保存于文件系统。

下例演示了添加文件 "test.txt" 作为一个 MailMessage 的附件。

[ C# ]

MailMessage mail = new MailMessage();
mail.To = "me@mycompany.com";
mail.From = "you@yourcompany.com";
mail.Subject = "this is a test email.";
mail.Body = "this is my test email body.";
//创建附件
MailAttachment attachment = new MailAttachment( Server.MapPath( "test.txt" ) );
//添加附件
mail.Attachments.Add( attachment );
//your real server goes here SmtpMail.Send( mail );
SmtpMail.SmtpServer = "localhost";

[ VB.NET ]

Dim mail As New MailMessage()
mail.To = "me@mycompany.com"
mail.From = "you@yourcompany.com"
mail.Subject = "this is a test email."
mail.Body = "this is my test email body."
'create the attachment
Dim attachment As New MailAttachment(Server.MapPath("test.txt"))
'add the attachment
mail.Attachments.Add(attachment)
'your real server goes here SmtpMail.Send(mail)
SmtpMail.SmtpServer = "localhost"

译者注：在实际操作中，发送的附件必须位于服务器端，发送附件才会成功。
因此，在客户端发送带附件的邮件时，必须先将附件上传至服务器端。

2.4 如何将 FROM 地址改成友好的名字?

通常, 许多人将 MailMessage 类（class）的 FROM 属性设置成这样： 
mail.From = "me@mycompny.com"
这样做的话，email 地址将会显示在大多数 email阅读器，比如
Outlook, Outlook Express, 或者 Eudora 的 FROM 行。为了显示
友好的名字（而不是 email 地址）, 可以利用下面的语法。 
mail.From = "\"John Smith\" "
下面的代码片断（snippet）演示了这样技术。

[ C# ]

MailMessage mail = new MailMessage();
mail.To = "me@mycompany.com";
mail.From = "\"John Smith\" ";    // 友好的名字
mail.Subject = "this is a test email.";
mail.Body = "this is my test email body.";
//your real server goes here SmtpMail.Send( mail );
SmtpMail.SmtpServer = "localhost";

[ VB.NET ]

Dim mail As New MailMessage()
mail.To = "me@mycompany.com"
mail.From = """John Smith"" "
mail.Subject = "this is a test email."
mail.Body = "this is my test email body."
'your real server goes here SmtpMail.Send(mail)
SmtpMail.SmtpServer = "localhost"
2.5 如何将 TO 地址改成友好的名字?

用来显示友好的 FROM 名字的技术, 和用来显示友好的 TO 与 CC 字段
的技术一样。通常典型的 .To 代码像这样： 
mail.To = "me@mycompny.com"
这样做的话，email 地址将会显示在大多数 email阅读器，比如
Outlook, Outlook Express, 或者 Eudora 的 TO 行。为了显示
友好的名字（而不是 email 地址）, 可以利用下面的语法。 
mail.To = "\"Jane Doe\" ""
下面的代码片断（snippet）演示了这样技术。

[ C# ]

MailMessage mail = new MailMessage();
mail.To = "\"Jane Doe\" ";    // 友好的名字
mail.From = "\"John Smith\" ";
mail.Subject = "this is a test email.";
mail.Body = "this is my test email body.";
//your real server goes here SmtpMail.Send( mail );
SmtpMail.SmtpServer = "localhost";

[ VB.NET ]

Dim mail As New MailMessage()
mail.To = """Jane Doe"" "
mail.From = """John Smith"" "
mail.Subject = "this is a test email."
mail.Body = "this is my test email body."
'your real server goes here SmtpMail.Send(mail)

SmtpMail.SmtpServer = "localhost"