HttpClientHandler.AllowAutoRedirect Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
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
.