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 terjadi; jika tidak, false. Defaultnya adalah false.

Keterangan

Hati

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

Setelah permintaan klien ke Uri tertentu berhasil diautentikasi, jika PreAuthenticatetrue dan kredensial disediakan, header Otorisasi dikirim dengan setiap permintaan ke Uri apa pun yang cocok dengan Uri tertentu hingga garis miring terakhir. Jadi, jika permintaan klien berhasil diautentikasi ke Uri tertentu yang berisi yang berikut ini:

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

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

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 Uri berikut:

http://www.contoso.com/

http://www.contoso.com/firstpath

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

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

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

Dengan pengecualian permintaan pertama, properti PreAuthenticate menunjukkan apakah akan mengirim informasi autentikasi dengan permintaan berikutnya ke Uri yang cocok dengan Uri spesifik hingga garis miring maju 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 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 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.