SocketsHttpHandler.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 program obsługi powinien postępować zgodnie z odpowiedziami przekierowania; w przeciwnym razie false. Wartość domyślna to true.
Uwagi
Ustaw wartość AllowAutoRedirect , true jeśli chcesz, aby program obsługi automatycznie podążał za nagłówkami przekierowania HTTP do nowej lokalizacji zasobu. Maksymalna liczba przekierowań do naśladowania 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 Autoryzacja jest czyszczone w przypadku automatycznych przekierowań, a program obsługi automatycznie próbuje ponownie uwierzytelnić się w lokalizacji przekierowanej. Żadne inne nagłówki nie są czyszczone. W praktyce oznacza to, że aplikacja nie może umieścić niestandardowych informacji uwierzytelniania w nagłówku Autoryzacja, jeśli istnieje możliwość napotkania przekierowania. Zamiast tego aplikacja musi zaimplementować i zarejestrować niestandardowy moduł uwierzytelniania.
Jeśli używasz plików cookie, dodając je do Headers kolekcji, nie są one czyszczone, gdy następuje przekierowanie, ponieważ program obsługi nie ma możliwości poznania domeny, dla której jest dozwolony 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
Procedura obsługi nigdy nie jest zgodna z przekierowaniem z protokołu HTTPS do protokołu HTTP, nawet jeśli AllowAutoRedirect jest ustawiona na truewartość .