SmtpClient.Credentials Properti

Definisi

Ruang nama:

System.Net.Mail

Rakitan:

System.Net.Mail.dll

Sumber:

SmtpClient.cs

Mendapatkan atau mengatur kredensial yang digunakan untuk mengautentikasi pengirim.

public:
 property System::Net::ICredentialsByHost ^ Credentials { System::Net::ICredentialsByHost ^ get(); void set(System::Net::ICredentialsByHost ^ value); };

public System.Net.ICredentialsByHost? Credentials { get; set; }

member this.Credentials : System.Net.ICredentialsByHost with get, set

Public Property Credentials As ICredentialsByHost

Nilai Properti

ICredentialsByHost

ICredentialsByHost yang mewakili kredensial yang akan digunakan untuk autentikasi; atau null jika tidak ada kredensial yang ditentukan.

Pengecualian

InvalidOperationException

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

Contoh

Contoh kode berikut menunjukkan pengaturan kredensial yang digunakan untuk mengirim email.

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

Beberapa server SMTP mengharuskan klien diautentikasi sebelum server akan mengirim email atas namanya. Untuk menggunakan kredensial jaringan default, Anda dapat mengatur ke UseDefaultCredentialstrue alih-alih mengatur properti ini. 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.

Informasi kredensial juga dapat ditentukan menggunakan file konfigurasi aplikasi dan mesin. Untuk informasi selengkapnya, lihat <Elemen MailSettings> (Pengaturan Jaringan). Jika informasi ditentukan menggunakan Credentials properti , informasi ini akan mengambil alih pengaturan file konfigurasi.

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.