HttpClientHandler.AllowAutoRedirect Properti

Definisi

Ruang nama:

System.Net.Http

Rakitan:

System.Net.Http.dll

Sumber:

HttpClientHandler.cs

Mendapatkan atau menetapkan nilai yang menunjukkan apakah handler harus mengikuti respons pengalihan.

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

public bool AllowAutoRedirect { get; set; }

member this.AllowAutoRedirect : bool with get, set

Public Property AllowAutoRedirect As Boolean

Nilai Properti

Boolean

true jika handler harus mengikuti respons pengalihan; jika tidak false. Nilai defaultnya adalah true.

Keterangan

Atur AllowAutoRedirect ke true jika Anda ingin handler secara otomatis mengikuti header pengalihan HTTP ke lokasi baru sumber daya. Jumlah maksimum pengalihan yang harus diikuti diatur oleh MaxAutomaticRedirections properti .

Jika AllowAutoRedirect diatur ke false, semua respons HTTP dengan kode status HTTP dari 300 hingga 399 dikembalikan ke aplikasi.

Header Otorisasi dibersihkan pada pengalihan otomatis dan handler secara otomatis mencoba mengautentikasi ulang ke lokasi yang dialihkan. Tidak ada header lain yang dibersihkan. Dalam praktiknya, ini berarti bahwa aplikasi tidak dapat menempatkan informasi autentikasi kustom ke header Otorisasi jika memungkinkan untuk menemukan pengalihan. Sebagai gantinya, aplikasi harus menerapkan dan mendaftarkan modul autentikasi kustom.

Jika Anda menggunakan cookie dengan secara khusus menambahkannya ke Headers koleksi, ini tidak dibersihkan ketika pengalihan diikuti, karena handler tidak memiliki cara untuk mengetahui domain apa yang diizinkan cookie. Jika Anda ingin meniru perilaku browser, gunakan CookieContainer kelas yang memungkinkan Anda menentukan domain target untuk cookie.

Catatan

Dengan AllowAutoRedirect diatur ke true, .NET Framework akan mengikuti pengalihan bahkan ketika dialihkan ke URI HTTP dari URI HTTPS. .NET Core versi 1.0, 1.1 dan 2.0 tidak akan mengikuti pengalihan dari HTTPS ke HTTP bahkan jika AllowAutoRedirect diatur ke true.