HttpWebRequest.PreAuthenticate Properti

Definisi

Ruang nama:

System.Net

Rakitan:

netstandard.dll, System.Net.Requests.dll

Sumber:

HttpWebRequest.cs

Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan mengirim header Otorisasi dengan permintaan.

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

public override bool PreAuthenticate { get; set; }

member this.PreAuthenticate : bool with get, set

Public Overrides Property PreAuthenticate As Boolean

Nilai Properti

Boolean

true untuk mengirim header Otorisasi HTTP dengan permintaan setelah autentikasi terjadi; jika tidak, false. Defaultnya adalah false.

Keterangan

Hati

WebRequest, , HttpWebRequestServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Setelah permintaan klien ke permintaan tertentu Uri berhasil diautentikasi, jika PreAuthenticate adalah true dan kredensial disediakan, header Otorisasi dikirim dengan setiap permintaan ke yang Uri cocok dengan garis miring penerusan terakhir.Uri Jadi, jika permintaan klien berhasil diautentikasi ke spesifik Uri yang berisi yang berikut ini:

http://www.contoso.com/firstpath/

Kemudian header Otorisasi untuk pra-autentikasi dikirim dengan setiap permintaan ke salah satu instans berikut Uri :

http://www.contoso.com/firstpath/

http://www.contoso.com/firstpath/default

http://www.contoso.com/firstpath/default.html

http://www.contoso.com/firstpath/sample.html

Namun, header Otorisasi tidak dikirim dengan permintaan ke salah satu instans berikut Uri :

http://www.contoso.com/

http://www.contoso.com/firstpath

http://www.contoso.com/secondpath/

http://www.contoso.com/firstpath/thirdpath/

Jika permintaan klien ke permintaan tertentu Uri tidak berhasil diautentikasi, permintaan menggunakan prosedur autentikasi standar.

Dengan pengecualian permintaan pertama, PreAuthenticate properti menunjukkan apakah akan mengirim informasi autentikasi dengan permintaan berikutnya ke Uri yang cocok dengan garis Uri miring terakhir tanpa menunggu untuk ditantang oleh server.

Dialog berikut antara klien dan server mengilustrasikan efek properti ini. Dialog mengasumsikan bahwa autentikasi dasar sedang digunakan.

PreAuthenticate adalah false:

Klien: GET someUrl

Server: 401 WWW-Authenticate Basic

Klien: GET dengan header Otorisasi

Server: 200 OK

Klien: GET someUrl

Server: 401 WWW-Authenticate Basic

Klien: GET dengan header Otorisasi

Server: 200 OK

PreAuthenticate adalah true:

Klien: GET someUrl

Server: 401 WWW-Authenticate Basic

Klien: GET dengan header Otorisasi

Server: 200 OK

Klien: GET someUrl dengan header Otorisasi

Jika skema autentikasi tidak mendukung praautentikasi, nilai properti ini diabaikan.