HttpClientHandler.AllowAutoRedirect Właściwość

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

Źródło:

HttpClientHandler.cs

Pobiera lub ustawia wartość wskazującą, czy program obsługi powinien postępować zgodnie z odpowiedziami przekierowania.

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

Wartość właściwości

Boolean

true jeśli procedura obsługi powinna być zgodna z odpowiedziami przekierowania; w przeciwnym razie false. Wartość domyślna to true.

Uwagi

Ustaw AllowAutoRedirect wartość na true , jeśli chcesz, aby program obsługi automatycznie śledził nagłówki przekierowania HTTP do nowej lokalizacji zasobu. Maksymalna liczba przekierowań do obserwowanych jest ustawiana przez MaxAutomaticRedirections właściwość .

Jeśli AllowAutoRedirect ustawiono wartość false, wszystkie odpowiedzi HTTP z kodem stanu HTTP z zakresu od 300 do 399 są zwracane do aplikacji.

Nagłówek autoryzacji jest czyszczone po automatycznych przekierowaniach, a procedura obsługi automatycznie próbuje ponownie uwierzytelnić się w przekierowanej lokalizacji. Żadne inne nagłówki nie są czyszczone. W praktyce oznacza to, że aplikacja nie może umieścić niestandardowych informacji uwierzytelniania w nagłówku autoryzacji, jeśli istnieje możliwość napotkania przekierowania. Zamiast tego aplikacja musi zaimplementować i zarejestrować niestandardowy moduł uwierzytelniania.

Jeśli używasz plików cookie przez dodanie ich do Headers kolekcji, nie zostaną one wyczyszczone, gdy nastąpi przekierowanie, ponieważ program obsługi nie ma możliwości poznania domeny, dla której dozwolony jest plik cookie. Jeśli chcesz naśladować zachowanie przeglądarki, użyj CookieContainer klasy , która umożliwia określenie domeny docelowej dla pliku cookie.

Uwaga

Po AllowAutoRedirect ustawieniu truewartości na wartość .NET Framework nastąpi przekierowanie nawet w przypadku przekierowania do identyfikatora URI HTTP z identyfikatora URI HTTPS. Platforma .NET Core w wersji 1.0, 1.1 i 2.0 nie będzie stosować przekierowania z protokołu HTTPS do protokołu HTTP, nawet jeśli AllowAutoRedirect jest ustawiona na truewartość .