HttpClientHandler.AllowAutoRedirect Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setPublic Property AllowAutoRedirect As BooleanWartość właściwości
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ść .
