WebProxy.UseDefaultCredentials Properti

Definisi

Ruang nama:

System.Net

Rakitan:

netstandard.dll, 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 menyetel 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 permintaan dibuat.

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

Credentials nilai	UseDefaultCredentials nilai	Efek
DefaultCredentials	true	Tidak ada efek.
DefaultCredentials	false	Credentials diatur ke null.
null	true	Credentials diatur ke DefaultCredentials.
Nilai apa pun selain DefaultCredentials atau null	true atau false	Pengaturan UseDefaultCredentials melemparkan pengecualian.

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