MailMessage Konstruktor

Definisi

Ruang nama:

System.Net.Mail

Rakitan:

System.Net.Mail.dll

Menginisialisasi instans baru kelas MailMessage.

Overload

MailMessage()	Menginisialisasi instans MailMessage kosong kelas.
MailMessage(MailAddress, MailAddress)	Menginisialisasi instans MailMessage baru kelas dengan menggunakan objek kelas yang ditentukan MailAddress .
MailMessage(String, String)	Menginisialisasi instans MailMessage baru kelas dengan menggunakan objek kelas yang ditentukan String .
MailMessage(String, String, String, String)	Menginisialisasi instans baru kelas MailMessage.

MailMessage()

Sumber:

MailMessage.cs

Menginisialisasi instans MailMessage kosong kelas.

public:
 MailMessage();

public MailMessage ();

Public Sub New ()

Keterangan

Dari diatur ke nilai dalam elemen jaringan untuk mailSettings<smtp> Element (Pengaturan Jaringan), jika ada.

MailMessage(MailAddress, MailAddress)

Sumber:

MailMessage.cs

Menginisialisasi instans MailMessage baru kelas dengan menggunakan objek kelas yang ditentukan 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)

Parameter

from

MailAddress

MailAddress yang berisi alamat pengirim pesan email.

to

MailAddress

yang MailAddress berisi alamat penerima pesan email.

Pengecualian

ArgumentNullException

fromadalah null.

-atau-

toadalah null.

FormatException

from atau to cacat.

Contoh

Contoh kode berikut menunjukkan panggilan konstruktor ini.

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

Keterangan

Properti From diinisialisasi menggunakan from dan properti diinisialisasi To menggunakan to.

MailMessage(String, String)

Sumber:

MailMessage.cs

Menginisialisasi instans MailMessage baru kelas dengan menggunakan objek kelas yang ditentukan 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)

Parameter

from

String

String yang berisi alamat pengirim pesan email.

to

String

yang String berisi alamat penerima pesan email. Beberapa alamat email harus dipisahkan dengan karakter koma (",").

Pengecualian

ArgumentNullException

fromadalah null.

-atau-

toadalah null.

ArgumentException

from adalah Empty ("").

-atau-

to adalah Empty ("").

FormatException

from atau to cacat.

Contoh

Contoh kode berikut menunjukkan panggilan konstruktor ini.

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

Keterangan

Properti From diinisialisasi menggunakan from dan properti diinisialisasi To menggunakan to.

MailMessage(String, String, String, String)

Sumber:

MailMessage.cs

Menginisialisasi instans baru kelas 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)

Parameter

from

String

String yang berisi alamat pengirim pesan email.

to

String

yang String berisi alamat penerima pesan email. Beberapa alamat email harus dipisahkan dengan karakter koma (",").

subject

String

String yang berisi teks subjek.

body

String

yang String berisi isi pesan.

Pengecualian

ArgumentNullException

fromadalah null.

-atau-

toadalah null.

ArgumentException

from adalah Empty ("").

-atau-

to adalah Empty ("").

FormatException

from atau to cacat.

Contoh

Contoh kode berikut menunjukkan panggilan konstruktor ini.

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

Keterangan

Properti untuk objek baru MailMessage diinisialisasi sebagai berikut:

Parameter	Properti
from	From
to	To
subject	Subject
body	Body

Secara default, subjek dan konten diasumsikan menggunakan pengodean default berdasarkan pengaturan komputer lokal. BodyEncoding Gunakan properti dan SubjectEncoding untuk menentukan pengodean yang berbeda.