MailMessage コンストラクター

定義

名前空間:

System.Net.Mail

アセンブリ:

System.Net.Mail.dll

MailMessage クラスの新しいインスタンスを初期化します。

オーバーロード

MailMessage()	MailMessage クラスの空のインスタンスを初期化します。
MailMessage(MailAddress, MailAddress)	MailMessage クラスのオブジェクトを指定して、MailAddress クラスの新しいインスタンスを初期化します。
MailMessage(String, String)	MailMessage クラスのオブジェクトを指定して、String クラスの新しいインスタンスを初期化します。
MailMessage(String, String, String, String)	MailMessage クラスの新しいインスタンスを初期化します。

MailMessage()

ソース:

MailMessage.cs

MailMessage クラスの空のインスタンスを初期化します。

public:
 MailMessage();

public MailMessage ();

Public Sub New ()

注釈

from は mailSettings<smtp> 要素 (ネットワーク設定) の network 要素の値に設定されます (存在する場合)。

MailMessage(MailAddress, MailAddress)

ソース:

MailMessage.cs

MailMessage クラスのオブジェクトを指定して、MailAddress クラスの新しいインスタンスを初期化します。

public:
 MailMessage(System::Net::Mail::MailAddress ^ from, System::Net::Mail::MailAddress ^ to);

public MailMessage (System.Net.Mail.MailAddress from, System.Net.Mail.MailAddress to);

new System.Net.Mail.MailMessage : System.Net.Mail.MailAddress * System.Net.Mail.MailAddress -> System.Net.Mail.MailMessage

Public Sub New (from As MailAddress, to As MailAddress)

パラメーター

from

MailAddress

電子メール メッセージの差出人のアドレスを格納している MailAddress。

to

MailAddress

電子メール メッセージの受信者のアドレスを格納している MailAddress。

例外

ArgumentNullException

from が nullです。

または

to が nullです。

FormatException

from または to の形式が正しくありません。

例

次のコード例では、このコンストラクターの呼び出しを示します。

static void CreateTestMessage3()
{
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com" );
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the new SMTP client.";
   message->Body = L"Using this new feature, you can send an email message from an application very easily.";
   
   // Use the application or machine configuration to get the 
   // host, port, and credentials.
   SmtpClient^ client = gcnew SmtpClient;
   Console::WriteLine( L"Sending an email message to {0} at {1} by using the SMTP host {2}.", to->User, to->Host, client->Host );
   client->Send( message );
}

public static void CreateTestMessage3()
{
    MailAddress to = new MailAddress("jane@contoso.com");
    MailAddress from = new MailAddress("ben@contoso.com");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    // Use the application or machine configuration to get the
    // host, port, and credentials.
    SmtpClient client = new SmtpClient();
    Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.",
        to.User, to.Host, client.Host);
    client.Send(message);
}

Public Shared Sub CreateTestMessage3()
    Dim [to] As MailAddress = New MailAddress("jane@contoso.com")
    Dim from As MailAddress = New MailAddress("ben@contoso.com")
    Dim message As MailMessage = New MailMessage(from, [to])
    message.Subject = "Using the new SMTP client."
    message.Body = "Using this new feature, you can send an email message from an application very easily."
    'Use the application or machine configuration to get the
    ' host, port, And credentials.
    Dim client As SmtpClient = New SmtpClient()
    Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.", [to].User, [to].Host, client.Host)
    client.Send(message)
End Sub

注釈

プロパティは From を使用して from 初期化され、 To プロパティは を使用して to初期化されます。

MailMessage(String, String)

ソース:

MailMessage.cs

MailMessage クラスのオブジェクトを指定して、String クラスの新しいインスタンスを初期化します。

public:
 MailMessage(System::String ^ from, System::String ^ to);

public MailMessage (string from, string to);

new System.Net.Mail.MailMessage : string * string -> System.Net.Mail.MailMessage

Public Sub New (from As String, to As String)

パラメーター

from

String

電子メール メッセージの差出人のアドレスを格納している String。

to

String

電子メール メッセージの受信者のアドレスを格納している String。 複数の電子メール アドレスは、コンマ文字 (",") で区切る必要があります。

例外

ArgumentNullException

from が nullです。

または

to が nullです。

ArgumentException

from が Empty ("") です。

または

to が Empty ("") です。

FormatException

from または to の形式が正しくありません。

例

次のコード例では、このコンストラクターの呼び出しを示します。

static void CreateTestMessage2( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the new SMTP client.";
   message->Body = L"Using this new feature, you can send an email message from an application very easily.";
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Credentials are necessary if the server requires the client 
   // to authenticate before it will send email on the client's behalf.
   client->UseDefaultCredentials = true;
   client->Send( message );
   client->~SmtpClient();
}

public static void CreateTestMessage2(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    SmtpClient client = new SmtpClient(server);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = true;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateTestMessage2(): {0}",
            ex.ToString());
    }
}

Public Shared Sub CreateTestMessage2(ByVal server As String)
    Dim [to] As String = "jane@contoso.com"
    Dim from As String = "ben@contoso.com"
    Dim message As MailMessage = New MailMessage(from, [to])
    message.Subject = "Using the new SMTP client."
    message.Body = "Using this new feature, you can send an email message from an application very easily."
    Dim client As SmtpClient = New SmtpClient(server)
    ' Credentials are necessary if the server requires the client
    ' to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = True

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

注釈

プロパティは From を使用して from 初期化され、 To プロパティは を使用して to初期化されます。

MailMessage(String, String, String, String)

ソース:

MailMessage.cs

MailMessage クラスの新しいインスタンスを初期化します。

public:
 MailMessage(System::String ^ from, System::String ^ to, System::String ^ subject, System::String ^ body);

public MailMessage (string from, string to, string? subject, string? body);

new System.Net.Mail.MailMessage : string * string * string * string -> System.Net.Mail.MailMessage

Public Sub New (from As String, to As String, subject As String, body As String)

パラメーター

from

String

電子メール メッセージの差出人のアドレスを格納している String。

to

String

電子メール メッセージの受信者のアドレスを格納している String。 複数の電子メール アドレスは、コンマ文字 (",") で区切る必要があります。

subject

String

件名のテキストを格納している String。

body

String

メッセージ本文を格納している String。

例外

ArgumentNullException

from が nullです。

または

to が nullです。

ArgumentException

from が Empty ("") です。

または

to が Empty ("") です。

FormatException

from または to の形式が正しくありません。

例

次のコード例では、このコンストラクターの呼び出しを示します。

static void CreateTimeoutTestMessage( String^ server )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew SmtpClient( server );
   Console::WriteLine( L"Changing time out from {0} to 100.", client->Timeout );
   client->Timeout = 100;
   
   // Credentials are necessary if the server requires the client 
   // to authenticate before it will send email on the client's behalf.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
}

public static void CreateTimeoutTestMessage(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server);
    Console.WriteLine("Changing time out from {0} to 100.", client.Timeout);
    client.Timeout = 100;
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Public Shared Sub CreateTimeoutTestMessage(ByVal server As String)
    Dim [to] As String = "jane@contoso.com"
    Dim from As String = "ben@contoso.com"
    Dim subject As String = "Using the new SMTP client."
    Dim body As String = "Using this new feature, you can send an email message from an application very easily."
    Dim message As MailMessage = New MailMessage(from, [to], subject, body)
    Dim client As SmtpClient = New SmtpClient(server)
    Console.WriteLine("Changing time out from {0} to 100.", client.Timeout)
    client.Timeout = 100
    ' Credentials are necessary if the server requires the client
    ' to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials
    client.Send(message)
End Sub

注釈

新しい MailMessage オブジェクトのプロパティは、次のように初期化されます。

パラメーター	プロパティ
from	From
to	To
subject	Subject
body	Body

既定では、サブジェクトとコンテンツは、ローカル コンピューターの設定に基づいて既定のエンコードを使用するものと見なされます。 プロパティと SubjectEncoding プロパティをBodyEncoding使用して、さまざまなエンコードを指定します。