HttpClientHandler.AllowAutoRedirect Properti

Definisi

Ruang nama:

System.Net.Http

Rakitan:

netstandard.dll, 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 mengalami 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 cookie diizinkan. Jika Anda ingin meniru perilaku browser, gunakan CookieContainer kelas yang memungkinkan Anda menentukan domain target untuk cookie.

Nota

Pada .NET Core dan .NET 5 dan versi yang lebih baru, pengaturan AllowAutoRedirect ke truetidak mengaktifkan pengalihan otomatis ke URI HTTP dari URI HTTPS. Pengalihan seperti itu (aman untuk tidak aman) hanya diikuti pada .NET Framework.