Export (0) Print
Expand All

MailMessage::AlternateViews Property

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

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

property AlternateViewCollection^ AlternateViews {
	AlternateViewCollection^ get ();

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.

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

   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);

      // 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 );


.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

© 2014 Microsoft