MailMessage.AlternateViews Property (System.Net.Mail)

AlternateViews Property

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

MailMessage..::.AlternateViews Property

Updated: November 2007

Gets the attachment collection used to store alternate forms of the message body.

Namespace: System.Net.Mail
Assembly: System (in System.dll)

Syntax

Visual Basic (Declaration)

Public ReadOnly Property AlternateViews As AlternateViewCollection

Visual Basic (Usage)

Dim instance As MailMessage
Dim value As AlternateViewCollection

value = instance.AlternateViews

public AlternateViewCollection AlternateViews { get; }

Visual C++

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

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

JScript

public function get AlternateViews () : AlternateViewCollection

Property Value

Type: System.Net.Mail..::.AlternateViewCollection

A writable AttachmentCollection.

Remarks

Use the AlternateViews property to specify copies of an e-mail message in different formats. For example, if you send a message in HTML, you might also want to provide a plain text version in case some of the recipients use e-mail readers that cannot display HTML content.

To add an alternate view to a MailMessage object, create an Attachment for the view, and then add it to the collection returned by AlternateViews. Use the Body property to specify the text version and use the AlternateViews collection to specify views with other MIME types. Use the MediaTypeNames class members to specify the MIME type for the alternate view.

Examples

The following code example demonstrates creating and sending an e-mail message with a plain text and an HTML alternate view.

        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 = AlternateView.CreateAlternateViewFromString(body);
            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();
        }

Visual C++

static void CreateMessageWithMultipleViews( String^ server, String^ recipients )
{

   // Create a message and set up the recipients.
   MailMessage^ message = gcnew MailMessage( L"jane@contoso.com",recipients,L"This e-mail message has multiple views.",L"This is some plain text." );

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

   // Add the alternate body to the message.
   AlternateView^ alternate = AlternateView::CreateAlternateViewFromString(body);
   message->AlternateViews->Add(alternate);

   // Send the message.
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );

   // Display the values in the ContentType for the attachment.
   ContentType^ c = alternate->ContentType;
   Console::WriteLine( L"Content type" );
   Console::WriteLine( c );
   Console::WriteLine( L"Boundary {0}", c->Boundary );
   Console::WriteLine( L"CharSet {0}", c->CharSet );
   Console::WriteLine( L"MediaType {0}", c->MediaType );
   Console::WriteLine( L"Name {0}", c->Name );
   Console::WriteLine( L"Parameters: {0}", c->Parameters->Count );
   IEnumerator^ myEnum = c->Parameters->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DictionaryEntry^ d = safe_cast<DictionaryEntry^>(myEnum->Current);
      Console::WriteLine( L"{0} = {1}", d->Key, d->Value );
   }

   Console::WriteLine();
   alternate->~AlternateView();
}

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 = AlternateView.CreateAlternateViewFromString(body);
    message.get_AlternateViews().Add(alternate);

    // Send the message.
    SmtpClient client = new SmtpClient(server);
    client.set_Credentials(CredentialCache.get_DefaultNetworkCredentials());
    client.Send(message);
    // Display the values in the ContentType for the attachment.
    ContentType c = alternate.get_ContentType();
    Console.WriteLine("Content type");
    Console.WriteLine(c.ToString());
    Console.WriteLine("Boundary {0}", c.get_Boundary());
    Console.WriteLine("CharSet {0}", c.get_CharSet());
    Console.WriteLine("MediaType {0}", c.get_MediaType());
    Console.WriteLine("Name {0}", c.get_Name());
    Console.WriteLine("Parameters: {0}", System.Convert.ToString(
        c.get_Parameters().get_Count()));
    IEnumerator myEnumerator = (IEnumerator)c.get_Parameters().
        GetEnumerator();
    while (myEnumerator.MoveNext()) {
        DictionaryEntry d = (DictionaryEntry)myEnumerator.get_Current();
        Console.WriteLine("{0} = {1}", d.get_Key(), d.get_Value());
    }

    Console.WriteLine();
    alternate.Dispose();
} //CreateMessageWithMultipleViews

Platforms

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

MailMessage Class

MailMessage Members

System.Net.Mail Namespace

Product Families

Resources

About Microsoft

Popular Places

Popular Searches

Popular Downloads

Property Value

.NET Framework

Reference