MailMessage 類別

參考

定義

命名空間:: System.Net.Mail

組件:: System.Net.Mail.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

表示可以使用 SmtpClient 類別傳送的電子郵件訊息。

public ref class MailMessage : IDisposable

public class MailMessage : IDisposable

type MailMessage = class
    interface IDisposable

Public Class MailMessage
Implements IDisposable

繼承: Object
MailMessage

實作: IDisposable

範例

下列程式碼範例示範如何建立及傳送包含附件的電子郵件訊息。

static void CreateMessageWithAttachment( String^ server )
{
   
   // Specify the file to be attached and sent.
   // This example assumes that a file named Data.xls exists in the
   // current working directory.
   String^ file = L"data.xls";
   
   // Create a message and set up the recipients.
   MailMessage^ message = gcnew MailMessage( L"jane@contoso.com",L"ben@contoso.com",L"Quarterly data report.",L"See the attached spreadsheet." );
   
   // Create  the file attachment for this email message.
   Attachment^ data = gcnew Attachment(file, MediaTypeNames::Application::Octet);
   
   // Add time stamp information for the file.
   ContentDisposition^ disposition = data->ContentDisposition;
   disposition->CreationDate = System::IO::File::GetCreationTime( file );
   disposition->ModificationDate = System::IO::File::GetLastWriteTime( file );
   disposition->ReadDate = System::IO::File::GetLastAccessTime( file );
   
   // Add the file attachment to this email message.
   message->Attachments->Add( data );
   
   //Send the message.
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Add credentials if the SMTP server requires them.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   
   // Display the values in the ContentDisposition for the attachment.
   ContentDisposition^ cd = data->ContentDisposition;
   Console::WriteLine( L"Content disposition" );
   Console::WriteLine( cd );
   Console::WriteLine( L"File {0}", cd->FileName );
   Console::WriteLine( L"Size {0}", cd->Size );
   Console::WriteLine( L"Creation {0}", cd->CreationDate );
   Console::WriteLine( L"Modification {0}", cd->ModificationDate );
   Console::WriteLine( L"Read {0}", cd->ReadDate );
   Console::WriteLine( L"Inline {0}", cd->Inline );
   Console::WriteLine( L"Parameters: {0}", cd->Parameters->Count );
   IEnumerator^ myEnum1 = cd->Parameters->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      DictionaryEntry^ d = safe_cast<DictionaryEntry^>(myEnum1->Current);
      Console::WriteLine( L"{0} = {1}", d->Key, d->Value );
   }

   data->~Attachment();
   client->~SmtpClient();
}

public static void CreateMessageWithAttachment(string server)
{
    // Specify the file to be attached and sent.
    // This example assumes that a file named Data.xls exists in the
    // current working directory.
    string file = "data.xls";
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
        "jane@contoso.com",
        "ben@contoso.com",
        "Quarterly data report.",
        "See the attached spreadsheet.");

    // Create  the file attachment for this email message.
    Attachment data = new Attachment(file, MediaTypeNames.Application.Octet);
    // Add time stamp information for the file.
    ContentDisposition disposition = data.ContentDisposition;
    disposition.CreationDate = System.IO.File.GetCreationTime(file);
    disposition.ModificationDate = System.IO.File.GetLastWriteTime(file);
    disposition.ReadDate = System.IO.File.GetLastAccessTime(file);
    // Add the file attachment to this email message.
    message.Attachments.Add(data);

    //Send the message.
    SmtpClient client = new SmtpClient(server);
    // Add credentials if the SMTP server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateMessageWithAttachment(): {0}",
            ex.ToString());
    }
    // Display the values in the ContentDisposition for the attachment.
    ContentDisposition cd = data.ContentDisposition;
    Console.WriteLine("Content disposition");
    Console.WriteLine(cd.ToString());
    Console.WriteLine("File {0}", cd.FileName);
    Console.WriteLine("Size {0}", cd.Size);
    Console.WriteLine("Creation {0}", cd.CreationDate);
    Console.WriteLine("Modification {0}", cd.ModificationDate);
    Console.WriteLine("Read {0}", cd.ReadDate);
    Console.WriteLine("Inline {0}", cd.Inline);
    Console.WriteLine("Parameters: {0}", cd.Parameters.Count);
    foreach (DictionaryEntry d in cd.Parameters)
    {
        Console.WriteLine("{0} = {1}", d.Key, d.Value);
    }
    data.Dispose();
}

Public Shared Sub CreateMessageWithAttachment(ByVal server As String)
    ' Specify the file to be attached And sent.
    ' This example assumes that a file named Data.xls exists in the
    ' current working directory.
    Dim file As String = "data.xls"
    ' Create a message and set up the recipients.
    Dim message As MailMessage = New MailMessage(
        "jane@contoso.com",
        "ben@contoso.com",
        "Quarterly data report.",
        "See the attached spreadsheet.")

    ' Create  the file attachment for this email message.
    Dim data As Attachment = New Attachment(file, MediaTypeNames.Application.Octet)
    ' Add time stamp information for the file.
    Dim disposition As ContentDisposition = data.ContentDisposition
    disposition.CreationDate = System.IO.File.GetCreationTime(file)
    disposition.ModificationDate = System.IO.File.GetLastWriteTime(file)
    disposition.ReadDate = System.IO.File.GetLastAccessTime(file)
    ' Add the file attachment to this email message.
    message.Attachments.Add(data)

    ' Send the message
    Dim client As SmtpClient = New SmtpClient(server)
    ' Add credentials if the SMTP server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials

    Try
        client.Send(message)
    Catch ex As Exception
        Console.WriteLine("Exception caught in CreateMessageWithAttachment(): {0}", ex.ToString())
    End Try

    ' Display the values in the ContentDisposition for the attachment.
    Dim cd As ContentDisposition = data.ContentDisposition
    Console.WriteLine("Content disposition")
    Console.WriteLine(cd.ToString())
    Console.WriteLine("File {0}", cd.FileName)
    Console.WriteLine("Size {0}", cd.Size)
    Console.WriteLine("Creation {0}", cd.CreationDate)
    Console.WriteLine("Modification {0}", cd.ModificationDate)
    Console.WriteLine("Read {0}", cd.ReadDate)
    Console.WriteLine("Inline {0}", cd.Inline)
    Console.WriteLine("Parameters: {0}", cd.Parameters.Count)

    For Each d As DictionaryEntry In cd.Parameters
        Console.WriteLine("{0} = {1}", d.Key, d.Value)
    Next

    data.Dispose()
End Sub

備註

類別的 MailMessage 實例是用來建構傳送至 SMTP 伺服器的電子郵件訊息，以使用 SmtpClient 類別傳遞。

當用來初始化 MailMessage 物件時 MailMessage ，電子郵件訊息的寄件者、收件者、主旨和本文可以指定為參數。您也可以使用物件上的 MailMessage 屬性來設定或存取這些參數。

您可以使用類別的下列屬性 MailMessage 來設定郵件的主要郵件訊息標頭和元素。

郵件標頭或元件	屬性
附件	Attachments
密件碳複製 (BCC)	Bcc
副本 (CC)	CC
Content-Type	BodyEncoding
自訂標頭的編碼	HeadersEncoding
訊息內文	Body
優先順序	Priority
收件者	To
Reply-To	ReplyToList
傳送者	From
主體	Subject

類別 MailMessage 也允許應用程式使用 Headers 屬性來存取訊息的標頭集合。雖然這個集合是唯讀的 (新集合無法設定) ，但自訂標頭可以新增至或從這個集合中刪除。傳送實例時，將會包含任何新增的 MailMessage 自訂標頭。在傳送訊息之前，只會將屬性中特別新增至這個集合的 Headers 標頭包含在集合中。 MailMessage傳送實例之後，屬性也會包含標頭， Headers 這些標頭會使用用來初始化 MailMessage 物件時 MailMessage 所傳遞之類別或參數的 MailMessage 相關聯屬性進行設定。

如果某些郵件標頭格式不正確，可能會導致電子郵件訊息損毀。因此，可以在類別上使用 MailMessage 屬性設定的標頭集合中的任何郵件標頭，都只能使用 MailMessage 類別屬性或初始化 MailMessage 物件時 MailMessage 傳遞的參數來設定。不應使用屬性新增下列郵件標頭清單， Headers 而且使用屬性設定的任何值，將會在傳送郵件時捨棄或覆寫這些標頭 Headers 的值：

密件副本
副本
Content-ID
內容位置
Content-Transfer-Encoding
Content-Type
Date
寄件者
重要性
MIME-Version
優先順序
Reply-To
傳送者
收件者
X 優先順序

如果應用程式未使用 Headers 屬性指定 X-Sender 標頭，類別 MailMessage 會在傳送訊息時建立一個標頭。

AlternateViews使用屬性可指定不同格式的電子郵件訊息複本。例如，如果您以 HTML 傳送郵件，您可能也想要提供純文字版本，以防某些收件者使用無法顯示 HTML 內容的電子郵件讀取器。如需示範如何使用替代檢視建立訊息的範例，請參閱 AlternateViews 。

Attachments使用屬性將附件新增至電子郵件訊息。如需示範如何使用附件建立郵件的範例，請參閱 Attachments 。呼叫 MailMessage 上的 Dispose 也會在每個參考的附件上呼叫 Dispose。

在組合電子郵件訊息之後，您可以使用或 SendAsync 方法來傳送。 Send

建構函式

MailMessage()	初始化 MailMessage 類別的空執行個體。
MailMessage(MailAddress, MailAddress)	使用指定的 MailMessage 類別物件，初始化 MailAddress 類別的新執行個體。
MailMessage(String, String)	使用指定的 MailMessage 類別物件，初始化 String 類別的新執行個體。
MailMessage(String, String, String, String)	初始化 MailMessage 類別的新執行個體。

屬性

AlternateViews	取得附件集合，用於儲存訊息主體的替代格式。
Attachments	取得附件集合，用於儲存附加到這個電子郵件訊息的資料。
Bcc	取得地址集合，其中包含這個電子郵件訊息的密件副本 (BCC) 收件者。
Body	取得或設定訊息主體。
BodyEncoding	取得或設定用來對訊息主體進行編碼的編碼方式。
BodyTransferEncoding	取得或設定用來對訊息主體進行編碼的傳輸編碼方式。
CC	取得地址集合，其中包含這個電子郵件訊息的副本 (CC) 收件者。
DeliveryNotificationOptions	取得或設定這個電子郵件訊息的傳遞告知。
From	取得或設定這個電子郵件訊息的寄件者地址。
Headers	取得與這個電子郵件訊息一起傳送的電子郵件標頭。
HeadersEncoding	取得或設定編碼，此編碼會用於此電子郵件訊息中的使用者定義自訂標頭。
IsBodyHtml	取得或設定值，指出郵件訊息主體是否採用 HTML 格式。
Priority	取得或設定這個電子郵件訊息的優先權。
ReplyTo	已過時。已過時。已過時。已過時。取得或設定郵件訊息的 ReplyTo 地址。
ReplyToList	取得郵件訊息回覆的地址清單。
Sender	取得或設定這個電子郵件訊息的寄件者地址。
Subject	取得或設定這個電子郵件訊息的主旨。
SubjectEncoding	取得或設定這個電子郵件訊息之主旨內容所用的編碼方式。
To	取得地址集合，其中包含這個電子郵件訊息的收件者。

方法

Dispose()	釋放 MailMessage 所使用的所有資源。
Dispose(Boolean)	釋放 MailMessage 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

適用於

MailMessage 類別

定義

範例

備註

建構函式

屬性

方法

適用於

其他資源