HttpWebRequest.PreAuthenticate Properti

Definisi

Ruang nama:

System.Net

Rakitan:

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 berlangsung; jika tidak, false. Default adalah false.

Keterangan

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

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

Kemudian header Otorisasi untuk praauthentikasi 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 spesifik 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 ke depan 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.