WebProxy.UseDefaultCredentials Properti

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebProxy.dll

Sumber:

WebProxy.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 mencoba mengatur properti ini ketika Credentials properti berisi kredensial selain kredensial default.

Keterangan

Atur properti ini ke true ketika permintaan yang dibuat oleh objek ini WebProxy harus, jika diminta oleh server, diautentikasi menggunakan kredensial pengguna yang saat ini masuk. Untuk aplikasi klien, ini adalah perilaku yang diinginkan dalam sebagian besar skenario. Untuk aplikasi tingkat menengah, seperti aplikasi ASP.NET, alih-alih menggunakan properti ini, Anda biasanya akan mengatur Credentials properti ke kredensial klien atas nama yang permintaannya dibuat.

Tabel berikut ini memperlihatkan efek pengaturan UseDefaultCredentials nilai, berdasarkan nilai Credentials properti .

Credentials nilai	UseDefaultCredentials nilai	Efek
DefaultCredentials	true	Tidak berpengaruh.
DefaultCredentials	false	Credentials diatur ke null.
null	true	Credentials diatur ke DefaultCredentials.
Nilai apa pun selain DefaultCredentials atau null	true atau false	Pengaturan UseDefaultCredentials memberikan pengecualian.

Jika UseDefaultCredentials adalah false, Anda dapat mengubah Credentials properti menjadi kredensial apa pun. Jika UseDefaultCredentials adalah true, mengubah Credentials properti dari DefaultCredentials (nilai yang diatur saat UseDefaultCredentials properti diatur ke true) akan memberikan pengecualian.