SmtpClient.UseDefaultCredentials Properti

Definisi

Ruang nama:

System.Net.Mail

Rakitan:

System.Net.Mail.dll

Sumber:

SmtpClient.cs

Mendapatkan atau menetapkan Boolean nilai yang mengontrol apakah DefaultCredentials dikirim dengan permintaan.

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

public bool UseDefaultCredentials { get; set; }

member this.UseDefaultCredentials : bool with get, set

Public Property UseDefaultCredentials As Boolean

Nilai Properti

Boolean

true jika kredensial default digunakan; jika tidak false. Nilai defaultnya adalah false.

Pengecualian

InvalidOperationException

Anda tidak dapat mengubah nilai properti ini ketika email sedang dikirim.

Contoh

Contoh kode berikut menunjukkan penggunaan properti 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());
    }
}

Keterangan

Beberapa server SMTP mengharuskan klien diautentikasi sebelum server mengirim email atas namanya. Atur properti ini ke true ketika objek ini SmtpClient harus, jika diminta oleh server, autentikasi menggunakan kredensial default pengguna yang saat ini masuk. Untuk aplikasi klien, ini adalah perilaku yang diinginkan dalam sebagian besar skenario.

Informasi kredensial juga dapat ditentukan menggunakan file konfigurasi aplikasi dan mesin. Untuk informasi selengkapnya, lihat <Elemen MailSettings> (Pengaturan Jaringan).

UseDefaultCredentials Jika properti diatur ke false, maka nilai yang diatur dalam Credentials properti akan digunakan untuk kredensial saat menyambungkan ke server. UseDefaultCredentials Jika properti diatur ke false dan Credentials properti belum diatur, maka email dikirim ke server secara anonim.

Perhatian

Jika Anda memberikan kredensial untuk autentikasi dasar, kredensial dikirim ke server dalam teks yang jelas. Ini dapat menyajikan masalah keamanan karena kredensial Anda dapat dilihat, lalu digunakan oleh orang lain.