MailMessage.AlternateViews MailMessage.AlternateViews MailMessage.AlternateViews MailMessage.AlternateViews Property


메시지 본문의 대체 형식을 저장하는 데 사용되는 첨부 파일 컬렉션을 가져옵니다.Gets the attachment collection used to store alternate forms of the message body.

 property System::Net::Mail::AlternateViewCollection ^ AlternateViews { System::Net::Mail::AlternateViewCollection ^ get(); };
public System.Net.Mail.AlternateViewCollection AlternateViews { get; }
member this.AlternateViews : System.Net.Mail.AlternateViewCollection
Public ReadOnly Property AlternateViews As AlternateViewCollection

속성 값


다음 코드 예제는 만들고 일반 텍스트 및 HTML 대체 뷰를 사용 하 여 전자 메일 메시지를 보내는 방법을 보여 줍니다.The following code example demonstrates creating and sending an email 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"",recipients,L"This email 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 );


public static void CreateMessageWithMultipleViews(string server, string recipients)
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
        "This email 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>";

    ContentType mimeType = new System.Net.Mime.ContentType("text/html");
    // Add the alternate body to the message.
    AlternateView alternate = AlternateView.CreateAlternateViewFromString(body, mimeType);

    // Send the message.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;

    catch (Exception ex)
        Console.WriteLine("Exception caught in CreateMessageWithMultipleViews(): {0}", 
    // Display the values in the ContentType for the attachment.
    ContentType c = alternate.ContentType;
    Console.WriteLine("Content type");
    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);


사용 된 AlternateViews 다양 한 형식의 전자 메일 메시지의 복사본을 지정 하는 속성입니다.Use the AlternateViews property to specify copies of an email message in different formats. 예를 들어 html에서 메시지를 보내는 경우 받는 사람에 게 일부 HTML 콘텐츠를 표시할 수 없는 전자 메일 프로그램을 사용 하면 일반 텍스트 버전을 제공 하려는 합니다.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 email readers that cannot display HTML content.

에 대체 보기를 추가 하는 MailMessage 개체를 만듭니다는 Attachment 보기의 경우에서 반환 된 컬렉션에 추가한 AlternateViews합니다.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. 사용 합니다 Body 속성을 텍스트 버전을 지정 하 고 사용 하 여는 AlternateViews MIME 형식과 다른 뷰를 지정 하는 컬렉션입니다.Use the Body property to specify the text version and use the AlternateViews collection to specify views with other MIME types. 사용 된 MediaTypeNames 클래스 대체 보기에 대 한 MIME 형식을 지정 하는 멤버입니다.Use the MediaTypeNames class members to specify the MIME type for the alternate view.

적용 대상