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> 元素的網路元素 (網路設定) 中的值。

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

根據預設，會假設主旨和內容會根據本機計算機設定使用預設編碼。 BodyEncoding使用和 SubjectEncoding 屬性來指定不同的編碼方式。