MailMessage.AlternateViews プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MailMessage.AlternateViews プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

メッセージ本文の別形式の表示内容を格納するために使用する添付データのコレクションを取得します。

名前空間: System.Net.Mail
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 AlternateViews As AlternateViewCollection

Visual Basic (使用法)

Dim instance As MailMessage
Dim value As AlternateViewCollection

value = instance.AlternateViews

public AlternateViewCollection AlternateViews { get;
 }

C++

public:
property AlternateViewCollection^ AlternateViews {
    AlternateViewCollection^ get ();
}

/** @property */
public AlternateViewCollection get_AlternateViews ()

JScript

public function get AlternateViews
 () : AlternateViewCollection

プロパティ値
書き込み可能な AttachmentCollection。

解説

AlternateViews プロパティを使用して、別の形式で電子メールメッセージのコピーを指定します。たとえば、HTML 形式でメッセージを送信する場合に、一部の受信者が HTML コンテンツを表示できない電子メールプログラムを使用しているときは、プレーンテキスト版も提供できます。

MailMessage オブジェクトに別形式の表示内容を追加するには、その表示内容のための Attachment を作成し、AlternateViews によって返されるコレクションに追加します。Body プロパティを使用してテキスト版を指定し、AlternateViews コレクションを使用して他の MIME タイプを使用するビューを指定します。MediaTypeNames クラスのメンバを使用して別形式の表示内容の MIME タイプを指定します。

使用例

プレーンテキストと HTML 形式の表示内容を含んだ電子メールメッセージの作成および送付を行うコード例を次に示します。

public static void CreateMessageWithMultipleViews(string
 server, string recipients)
{
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
        "jane@contoso.com",
        recipients,
        "This e-mail message has multiple views.",
        "This is some plain text.");

    // Construct the alternate body as HTML.
    string body = "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD
 HTML 4.0 Transitional//EN\">";
    body += "<HTML><HEAD><META http-equiv=Content-Type content=\"text/html;
 charset=iso-8859-1\">";
    body += "</HEAD><BODY><DIV><FONT face=Arial color=#ff0000
 size=2>this is some HTML text";
    body += "</FONT></DIV></BODY></HTML>";

    // Add the alternate body to the message.
    AlternateView alternate = new AlternateView(body, MediaTypeNames.Text.Html);
    message.AlternateViews.Add(alternate);

    // Send the message.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    // Display the values in the ContentType for the attachment.
    ContentType c = alternate.ContentType;
    Console.WriteLine("Content type");
    Console.WriteLine(c.ToString());
    Console.WriteLine("Boundary {0}", c.Boundary);
    Console.WriteLine("CharSet {0}", c.CharSet);
    Console.WriteLine("MediaType {0}", c.MediaType);
    Console.WriteLine("Name {0}", c.Name);
    Console.WriteLine("Parameters: {0}", c.Parameters.Count);
    foreach (DictionaryEntry d in c.Parameters)
    {
        Console.WriteLine("{0} = {1}", d.Key, d.Value);
    }
    Console.WriteLine();
    alternate.Dispose();
}