DOBON.NET プログラミング道: .NET Framework, VB.NET, C#, Visual Basic, Visual Studio, インストーラ, ...

■コンテンツ

■ブックマーク

■Translate

■その他

■広告

DOBON.NET > プログラミング道 > .NET Tips > インターネット

HTMLメールを送信する
- .NET Framework 2.0以降で、SmtpClientクラスを使用する方法
  - "multipart/alternative"としてHTMLメールを送信する
  - HTMLに画像を埋め込む
- SmtpMailクラスを使用する方法

HTMLメールを送信する

.NET Framework 2.0以降で、SmtpClientクラスを使用する方法

MailMessageクラスのIsBodyHtmlプロパティをtrueにすることにより、HTMLメールを送信することができます。

[VB.NET]
'MailMessageの作成
Dim msg As New System.Net.Mail.MailMessage("from@xxx.xxx", "to@xxx.xxx")
msg.Subject = "題名"
'HTMLメールとして送信する
msg.IsBodyHtml = True
msg.Body = "こんにちは。<br><a href=""http://dobon.net/"">DOBON.NET</a>"

Dim sc As New System.Net.Mail.SmtpClient()
'SMTPサーバーを指定する
sc.Host = "localhost"
'メッセージを送信する
sc.Send(msg)

'後始末
msg.Dispose()

[C#]
//MailMessageの作成
System.Net.Mail.MailMessage msg = new System.Net.Mail.MailMessage(
    "from@xxx.xxx", "to@xxx.xxx");
msg.Subject = "題名";
//HTMLメールとして送信する
msg.IsBodyHtml = true;
msg.Body = "こんにちは。<br><a href=\"http://dobon.net/\">DOBON.NET</a>";

System.Net.Mail.SmtpClient sc = new System.Net.Mail.SmtpClient();
//SMTPサーバーを指定する
sc.Host = "localhost";
//メッセージを送信する
sc.Send(msg);

//後始末
msg.Dispose();

上のようなコードで送信されるメールのデータは、次のようになります。

"multipart/alternative"としてHTMLメールを送信する

「Content-Type: multipart/alternative」としてHTMLの他にプレーンテキストのデータも付加するには、MailMessageクラスのAlternateViewsプロパティに適当なAlternateViewオブジェクトを追加します。AlternateViewオブジェクトは、AlternateView.CreateAlternateViewFromStringメソッドで簡単に作成できます。

[VB.NET]
'MailMessageの作成
Dim msg As New System.Net.Mail.MailMessage("from@xxx.xxx", "to@xxx.xxx")
msg.Subject = "題名"

'//プレーンテキストをBodyに追加
msg.Body = "こんにちは。" + vbCrLf + "DOBON.NET"

'HTMLを追加
'Encodingにnullを指定しているため、UTF-8/Base64でエンコードされる
Dim htmlView As System.Net.Mail.AlternateView = _
    System.Net.Mail.AlternateView.CreateAlternateViewFromString( _
        "こんにちは。<br><a href=""http://dobon.net/"">DOBON.NET</a>", _
        Nothing, System.Net.Mime.MediaTypeNames.Text.Html)
'HTMLの内容がファイルに格納されている場合は、次のようにする
'Dim htmlView As New System.Net.Mail.AlternateView( _
'    "C:\hello.html", System.Net.Mime.MediaTypeNames.Text.Html)
'Base64（デフォルト）、QuotedPrintable、SevenBit、Unknownを選択できる
htmlView.TransferEncoding = System.Net.Mime.TransferEncoding.Base64
'次のようにベースURLを指定できる
'htmlView.BaseUri = New Uri("http://dobon.net/")
msg.AlternateViews.Add(htmlView)

Dim sc As New System.Net.Mail.SmtpClient()
'SMTPサーバーを指定する
sc.Host = "localhost"
'メッセージを送信する
sc.Send(msg)

'後始末
msg.Dispose()

[C#]
//MailMessageの作成
System.Net.Mail.MailMessage msg = new System.Net.Mail.MailMessage(
    "from@xxx.xxx", "to@xxx.xxx");
msg.Subject = "題名";

////プレーンテキストをBodyに追加
msg.Body = "こんにちは。\r\nDOBON.NET";

//HTMLを追加
//Encodingにnullを指定しているため、UTF-8/Base64でエンコードされる
System.Net.Mail.AlternateView htmlView =
    System.Net.Mail.AlternateView.CreateAlternateViewFromString(
        "こんにちは。<br><a href=\"http://dobon.net/\">DOBON.NET</a>",
        null, System.Net.Mime.MediaTypeNames.Text.Html);
//HTMLの内容がファイルに格納されている場合は、次のようにする
//System.Net.Mail.AlternateView htmlView = new System.Net.Mail.AlternateView(
//    "C:\\hello.html", System.Net.Mime.MediaTypeNames.Text.Html);
//Base64（デフォルト）、QuotedPrintable、SevenBit、Unknownを選択できる
htmlView.TransferEncoding = System.Net.Mime.TransferEncoding.Base64;
//次のようにベースURLを指定できる
//htmlView.BaseUri = new Uri("http://dobon.net/");
msg.AlternateViews.Add(htmlView);

System.Net.Mail.SmtpClient sc = new System.Net.Mail.SmtpClient();
//SMTPサーバーを指定する
sc.Host = "localhost";
//メッセージを送信する
sc.Send(msg);

//後始末
msg.Dispose();

このコードを実行させると、次のようなメールのデータが送信されます。

上記の例では、MailMessage.Bodyにプレーンテキストを指定していますが、Bodyに何も指定せずに、HTMLと同じようにAlternateViewでプレーンテキストを追加しても同じ結果となります。

HTMLに画像を埋め込む

さらに、HTMLに画像を入れてみます。AlternateView.LinkedResourcesプロパティに画像のLinkedResourceを追加します。HTMLの画像へのリンクには、LinkedResource.ContentIdで指定しているIDを使用します。

[VB.NET]
'MailMessageの作成
Dim msg As New System.Net.Mail.MailMessage("from@xxx.xxx", "to@xxx.xxx")
msg.Subject = "題名"

'//プレーンテキストをBodyに追加
msg.Body = "こんにちは。" + vbCrLf + "DOBON.NET"

'HTMLを追加
'Encodingにnullを指定しているため、UTF-8でエンコードされる
'ContentIdを"dbs1"とする
Dim htmlView As System.Net.Mail.AlternateView = _
    System.Net.Mail.AlternateView.CreateAlternateViewFromString( _
        "<br><a href=""index.html""><img src=""cid:dbs1""></a>", _
        Nothing, System.Net.Mime.MediaTypeNames.Text.Html)
htmlView.BaseUri = New Uri("http://dobon.net/")
'HTML内の画像のLinkedResourceを作成
Dim res As New System.Net.Mail.LinkedResource("C:\dbs1.gif", "image/gif")
res.ContentId = "dbs1"
'Content-Locationを指定
res.ContentLink = New Uri("http://dobon.net/banner/dbs1.gif")
'LinkedResourceを追加
htmlView.LinkedResources.Add(res)
'AlternateViewを追加
msg.AlternateViews.Add(htmlView)

Dim sc As New System.Net.Mail.SmtpClient()
'SMTPサーバーを指定する
sc.Host = "localhost"
'メッセージを送信する
sc.Send(msg)

'後始末
msg.Dispose()

[C#]
//MailMessageの作成
System.Net.Mail.MailMessage msg = new System.Net.Mail.MailMessage(
    "from@xxx.xxx", "to@xxx.xxx");
msg.Subject = "題名";

//プレーンテキストをBodyに追加
msg.Body = "こんにちは。\r\nDOBON.NET";

//HTMLを追加
//Encodingにnullを指定しているため、UTF-8でエンコードされる
//ContentIdを"dbs1"とする
System.Net.Mail.AlternateView htmlView =
    System.Net.Mail.AlternateView.CreateAlternateViewFromString(
        "<br><a href=\"index.html\"><img src=\"cid:dbs1\"></a>",
        null, System.Net.Mime.MediaTypeNames.Text.Html);
htmlView.BaseUri = new Uri("http://dobon.net/");
//HTML内の画像のLinkedResourceを作成
System.Net.Mail.LinkedResource res =
    new System.Net.Mail.LinkedResource("C:\\dbs1.gif", "image/gif");
res.ContentId = "dbs1";
//Content-Locationを指定
res.ContentLink = new Uri("http://dobon.net/banner/dbs1.gif");
//LinkedResourceを追加
htmlView.LinkedResources.Add(res);
//AlternateViewを追加
msg.AlternateViews.Add(htmlView);

System.Net.Mail.SmtpClient sc = new System.Net.Mail.SmtpClient();
//SMTPサーバーを指定する
sc.Host = "localhost";
//メッセージを送信する
sc.Send(msg);

//後始末
msg.Dispose();

送信されるデータは、次のようになります。

mime-version: 1.0
from: from@xxx.xxx
to: to@xxx.xxx
date: 23 Jan 2007 00:56:38 +0900
content-type: multipart/mixed; boundary=--boundary_0_e459de52-94de-46a6-9371-322bdb9b4ff9

----boundary_0_e459de52-94de-46a6-9371-322bdb9b4ff9
content-type: multipart/alternative; boundary=--boundary_1_de9c08ea-2f13-4246-bea0-3366b26cad44

----boundary_1_de9c08ea-2f13-4246-bea0-3366b26cad44
content-type: text/plain; charset=utf-8
content-transfer-encoding: base64

44GT44KT44Gr44Gh44Gv44CCDQpET0JPTi5ORVQ=
----boundary_1_de9c08ea-2f13-4246-bea0-3366b26cad44
content-type: multipart/related;
 boundary=--boundary_2_7536a6da-9eb0-4ada-8068-90e194048aa9; type="text/html"
content-location: http://dobon.net/

----boundary_2_7536a6da-9eb0-4ada-8068-90e194048aa9
content-type: text/html; charset=us-ascii
content-transfer-encoding: quoted-printable
content-location: http://dobon.net/

<br><a href=3D"index.html"><img src=3D"cid:dbs1"></a>
----boundary_2_7536a6da-9eb0-4ada-8068-90e194048aa9
content-type: image/gif
content-transfer-encoding: base64
content-id: <dbs1>
content-location: http://dobon.net/banner/dbs1.gif

（省略）
----boundary_2_7536a6da-9eb0-4ada-8068-90e194048aa9--

----boundary_1_de9c08ea-2f13-4246-bea0-3366b26cad44--

----boundary_0_e459de52-94de-46a6-9371-322bdb9b4ff9--

SmtpMailクラスを使用する方法

MailMessage.BodyFormatプロパティをMailFormat.Htmlとすることにより、HTMLメールを送ることができます。このように送信されたメールは、「Content-Type: multipart/alternative」となり、HTMLとプレーンテキストのデータが送信されます。プレーンテキストのデータは、自動的に作成され、付加されます。

[VB.NET]
Dim mm As New System.Web.Mail.MailMessage()
'本文の文字コードを指定する（ここではJIS）
mm.BodyEncoding = System.Text.Encoding.GetEncoding(50220)
'送信者
mm.From = "sender@xxx.xxx"
'あて先
mm.To = "recipient1@xxx.xxx"
'件名
mm.Subject = "テスト"
'本文
'HTMLメールとする
mm.BodyFormat = System.Web.Mail.MailFormat.Html
mm.Body = "こんにちは。<br><a href=""http://dobon.net/"">DOBON.NET</a>"

'SMTPサーバーを指定する
System.Web.Mail.SmtpMail.SmtpServer = "localhost"
'送信する
System.Web.Mail.SmtpMail.Send(mm)

[C#]
System.Web.Mail.MailMessage mm = new System.Web.Mail.MailMessage();
//本文の文字コードを指定する（ここではJIS）
mm.BodyEncoding = System.Text.Encoding.GetEncoding(50220);
//送信者
mm.From = "sender@xxx.xxx";
//あて先
mm.To = "recipient1@xxx.xxx";
//件名
mm.Subject = "テスト";
//本文
//HTMLメールとする
mm.BodyFormat = System.Web.Mail.MailFormat.Html;
mm.Body = "こんにちは。<br><a href=\"http://dobon.net/\">DOBON.NET</a>";

//SMTPサーバーを指定する
System.Web.Mail.SmtpMail.SmtpServer = "localhost";
//送信する
System.Web.Mail.SmtpMail.Send(mm);

上記のコードで送信されるメールのデータは、次のようになります。

thread-index: Acc+BYZUvklIO1tyTzWLvZGZHmqamg==
Thread-Topic: =?iso-2022-jp?B?GyRCJUYlOSVIGyhC?=
From: <sender@xxx.xxx>
To: <recipient1@xxx.xxx>
Subject: =?iso-2022-jp?B?GyRCJUYlOSVIGyhC?=
Date: Mon, 22 Jan 2007 22:13:05 +0900
Message-ID: <000001c73e05$868dff80$0300a8c0@mainpc>
MIME-Version: 1.0
Content-Type: multipart/alternative;
    boundary="----=_NextPart_000_0001_01C73E50.F677F170"
X-Mailer: Microsoft CDO for Windows 2000
Content-Class: urn:content-classes:message
Importance: normal
Priority: normal
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3028

This is a multi-part message in MIME format.

------=_NextPart_000_0001_01C73E50.F677F170
Content-Type: text/plain;
    charset="iso-2022-jp"
Content-Transfer-Encoding: 7bit

こんにちは。
DOBON.NET <http://dobon.net/>

------=_NextPart_000_0001_01C73E50.F677F170
Content-Type: text/html;
    charset="iso-2022-jp"
Content-Transfer-Encoding: 7bit

こんにちは。<br><a href="http://dobon.net/">DOBON.NET</a>
------=_NextPart_000_0001_01C73E50.F677F170--

注意：この記事では、基本的な事柄の説明が省略されているかもしれません。初心者の方は、特に以下の点にご注意ください。

このサイトで紹介されているコードの多くは、例外処理が省略されています。例外処理については、こちらをご覧ください。

この記事への評価

この記事の評価はこちらでご覧いただけます。各Tipsの評価一覧はこちらです。

この記事へのコメント

この記事へのコメントの一覧はこちらでご覧いただけます。

この記事に関するコメントを投稿するには、下のボタンをクリックしてください。投稿フォームが表示されます。通常のご質問、ご意見等は掲示板へご投稿ください。

この記事へのトラックバック

この記事へのトラックバックの一覧はこちらでご覧いただけます。

この記事のトラックバック Ping URL (注意事項) :
http://dobon.net/cgi-bin/pc/tb.php/internet/htmlmail.html