SmtpClient.EnableSsl Properti

Definisi

Ruang nama:

System.Net.Mail

Rakitan:

System.Net.Mail.dll

Sumber:

SmtpClient.cs

Tentukan apakah SmtpClient menggunakan Secure Sockets Layer (SSL) untuk mengenkripsi koneksi.

public:
 property bool EnableSsl { bool get(); void set(bool value); };

public bool EnableSsl { get; set; }

member this.EnableSsl : bool with get, set

Public Property EnableSsl As Boolean

Nilai Properti

Boolean

trueSmtpClient jika menggunakan SSL; jika tidak, false. Default adalah false.

Contoh

Contoh kode berikut membuat koneksi SSL dengan server SMTP dan menggunakan koneksi untuk mengirim email.

public static void CreateTestMessage(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;
                client.EnableSsl = true;
    client.Send(message);
}

Keterangan

Properti EnableSsl menentukan apakah SSL digunakan untuk mengakses server email SMTP yang ditentukan.

Nilai default untuk properti ini juga dapat diatur dalam file konfigurasi komputer atau aplikasi. Setiap perubahan yang dilakukan pada EnableSsl properti akan mengambil alih pengaturan file konfigurasi.

Kelas SmtpClient hanya mendukung Ekstensi Layanan SMTP untuk SMTP Aman melalui Keamanan Lapisan Transportasi seperti yang didefinisikan dalam RFC 3207. Dalam mode ini, sesi SMTP dimulai pada saluran yang tidak terenkripsi, lalu perintah STARTTLS dikeluarkan oleh klien ke server untuk beralih ke komunikasi yang aman menggunakan SSL. Lihat RFC 3207 yang diterbitkan oleh Internet Engineering Task Force (IETF) untuk informasi selengkapnya.

Metode koneksi alternatif adalah tempat sesi SSL dibuat di depan sebelum perintah protokol dikirim. Metode koneksi ini terkadang disebut SMTP/SSL, SMTP melalui SSL, atau SMTPS dan secara default menggunakan port 465. Metode koneksi alternatif yang menggunakan SSL saat ini tidak didukung.

Anda dapat menggunakan ClientCertificates untuk menentukan sertifikat klien mana yang harus digunakan untuk membuat koneksi SSL. memungkinkan ServerCertificateValidationCallback Anda menolak sertifikat yang disediakan oleh server SMTP. Properti SecurityProtocol memungkinkan Anda menentukan versi protokol SSL yang akan digunakan.

Catatan

EnableSsl Jika properti diatur ke true, dan server email SMTP tidak mengiklankan STARTTLS sebagai respons terhadap perintah EHLO, maka panggilan ke Send metode atau SendAsync akan melempar SmtpException.

Lihat juga

• SmtpSection
• SmtpNetworkElement
• EnableSsl
• Elemen <mailSettings> (Pengaturan Jaringan)
• <smtp> Elemen (Pengaturan Jaringan)
• <Elemen jaringan> (Pengaturan Jaringan)