SmtpClient Konstruktor

Definisi

Ruang nama:

System.Net.Mail

Rakitan:

System.Net.Mail.dll

Menginisialisasi instans baru kelas SmtpClient.

Overload

SmtpClient()	Menginisialisasi instans SmtpClient baru kelas dengan menggunakan pengaturan file konfigurasi.
SmtpClient(String)	Menginisialisasi instans SmtpClient baru kelas yang mengirim email dengan menggunakan server SMTP yang ditentukan.
SmtpClient(String, Int32)	Menginisialisasi instans SmtpClient baru kelas yang mengirim email dengan menggunakan server dan port SMTP yang ditentukan.

SmtpClient()

Sumber:

SmtpClient.cs

Menginisialisasi instans SmtpClient baru kelas dengan menggunakan pengaturan file konfigurasi.

public:
 SmtpClient();

public SmtpClient ();

Public Sub New ()

Contoh

Contoh kode berikut menunjukkan pengiriman pesan email.

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);
}

Untuk contoh <node mailSettings> dalam file konfigurasi aplikasi atau mesin, lihat <mailSettings> Element (Pengaturan Jaringan).

Keterangan

Konstruktor ini menginisialisasi Hostproperti , Credentials, dan Port untuk yang baru SmtpClient dengan menggunakan pengaturan dalam file konfigurasi aplikasi atau mesin. Untuk informasi selengkapnya, lihat <MailSettings> Element (Pengaturan Jaringan).

SmtpClient(String)

Sumber:

SmtpClient.cs

Menginisialisasi instans SmtpClient baru kelas yang mengirim email dengan menggunakan server SMTP yang ditentukan.

public:
 SmtpClient(System::String ^ host);

public SmtpClient (string? host);

new System.Net.Mail.SmtpClient : string -> System.Net.Mail.SmtpClient

Public Sub New (host As String)

Parameter

host

String

String yang berisi nama atau alamat IP komputer host yang digunakan untuk transaksi SMTP.

Contoh

Contoh kode berikut menunjukkan pemanggilan 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);
}

Keterangan

Parameter host digunakan untuk menginisialisasi nilai Host properti . Properti Credentials dan Port diinisialisasi dengan menggunakan pengaturan dalam file konfigurasi aplikasi atau komputer. null Jika host atau sama dengan String.Empty, Host diinisialisasi menggunakan pengaturan dalam file konfigurasi aplikasi atau komputer.

Untuk informasi selengkapnya tentang menggunakan file konfigurasi aplikasi dan mesin, lihat <mailSettings> Element (Pengaturan Jaringan). Jika informasi ditentukan menggunakan SmtpClient konstruktor atau properti, informasi ini akan mengambil alih pengaturan file konfigurasi.

SmtpClient(String, Int32)

Sumber:

SmtpClient.cs

Menginisialisasi instans SmtpClient baru kelas yang mengirim email dengan menggunakan server dan port SMTP yang ditentukan.

public:
 SmtpClient(System::String ^ host, int port);

public SmtpClient (string? host, int port);

new System.Net.Mail.SmtpClient : string * int -> System.Net.Mail.SmtpClient

Public Sub New (host As String, port As Integer)

Parameter

host

String

String yang berisi nama atau alamat IP host yang digunakan untuk transaksi SMTP.

port

Int32

Lebih Int32 besar dari nol yang berisi port yang akan digunakan pada host.

Pengecualian

ArgumentOutOfRangeException

port tidak boleh kurang dari nol.

Contoh

Contoh kode berikut menunjukkan pemanggilan konstruktor ini.

static void CreateTestMessage1( String^ server, int port )
{
   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,port );
   
   // 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 );
   client->~SmtpClient();
}

public static void CreateTestMessage1(string server, int port)
{
    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, port);
    // 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);
}

Keterangan

Parameter host dan port masing-masing menetapkan nilai Host properti dan Port . null Jika host atau sama dengan String.Empty, Host diinisialisasi menggunakan pengaturan dalam file konfigurasi aplikasi atau komputer. Jika port nol, Port diinisialisasi menggunakan pengaturan dalam file konfigurasi aplikasi atau komputer. Properti Credentials diinisialisasi menggunakan pengaturan dalam file konfigurasi aplikasi atau komputer.

Untuk informasi selengkapnya tentang menggunakan file konfigurasi aplikasi dan mesin, lihat <mailSettings> Element (Pengaturan Jaringan). Jika informasi ditentukan menggunakan SmtpClient konstruktor atau properti, informasi ini akan mengambil alih pengaturan file konfigurasi.