MailMessage クラス

定義

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 プロパティを使用して設定できます。

クラスを MailMessage 使用すると、アプリケーションは プロパティを使用してメッセージのヘッダー コレクションに Headers アクセスすることもできます。 このコレクションは読み取り専用ですが (新しいコレクションは設定できません)、このコレクションにカスタム ヘッダーを追加したり、このコレクションから削除したりすることができます。 インスタンスが送信されると MailMessage 、追加されたすべてのカスタム ヘッダーが含まれます。 メッセージが送信される前に、 プロパティ内 Headers のこのコレクションに特別に追加されたヘッダーのみがコレクションに含まれます。 インスタンスがMailMessage送信されると、 プロパティには、 がオブジェクトのHeaders初期化MailMessageに使用されるときにMailMessage渡されるクラスまたはパラメーターのMailMessage関連付けられたプロパティを使用して設定されたヘッダーも含まれます。

一部のメール ヘッダーの形式が正しくない場合は、メール メッセージが破損する可能性があります。 そのため、 クラスの プロパティを使用して設定できる headers コレクション内のメール ヘッダーは、 クラス プロパティMailMessageを使用するか、 がオブジェクトをMailMessage初期化MailMessageするときにMailMessage渡されるパラメーターとしてのみ設定する必要があります。 プロパティを使用して次のメール ヘッダーの一覧を Headers 追加しないでください。また、 プロパティを使用して Headers これらのヘッダーに設定された値は、メッセージの送信時に破棄または上書きされます。

• [Bcc]

• [Cc]

• Content-ID

• Content-Location

• Content-Transfer-Encoding

• Content-Type

• Date

• ソース

• 重要度

• MIME-Version

• 優先度

• ［返信先］

• 送信者

• 終了

• X 優先度

アプリケーションで プロパティを使用して X-Sender ヘッダーを Headers 指定しない場合、 MailMessage クラスはメッセージの送信時に X-Sender ヘッダーを作成します。

電子メール メッセージの AlternateViews コピーをさまざまな形式で指定するには、 プロパティを使用します。 たとえば、HTML でメッセージを送信する場合、一部の受信者が HTML コンテンツを表示できない電子メール リーダーを使用する場合に備えて、プレーンテキスト バージョンを指定することもできます。 代替ビューを使用してメッセージを作成する例については、「」を参照してください AlternateViews。

プロパティを Attachments 使用して、電子メール メッセージに添付ファイルを追加します。 添付ファイルを含むメッセージを作成する例については、「」を参照してください Attachments。 MailMessage で Dispose を呼び出すと、参照されている各添付ファイルに対して Dispose も呼び出されます。

電子メール メッセージをアセンブルしたら、 メソッドまたは SendAsync メソッドをSend使用して送信できます。

コンストラクター

プロパティ

メソッド

適用対象