HttpClientHandler.AllowAutoRedirect HttpClientHandler.AllowAutoRedirect HttpClientHandler.AllowAutoRedirect HttpClientHandler.AllowAutoRedirect Property

Definicja

Pobiera lub ustawia wartość wskazującą, czy program obsługi powinien postępować zgodnie z odpowiedziami przekierowania.Gets or sets a value that indicates whether the handler should follow redirection responses.

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

trueJeśli program obsługi powinien postępować zgodnie z odpowiedziami przekierowania; w falseprzeciwnym razie.true if the handler should follow redirection responses; otherwise false. Wartość domyślna to true.The default value is true.

Uwagi

Ustaw AllowAutoRedirect natrue , jeśli chcesz, aby program obsługi automatycznie podążał za nagłówkami przekierowań HTTP do nowej lokalizacji zasobu.Set AllowAutoRedirect to true if you want the handler to automatically follow HTTP redirection headers to the new location of the resource. Maksymalna liczba przekierowań do wykonania jest ustawiana przez MaxAutomaticRedirections właściwość.The maximum number of redirections to follow is set by the MaxAutomaticRedirections property.

Jeśli AllowAutoRedirect jest ustawiona na false, wszystkie odpowiedzi HTTP z kodem stanu HTTP z 300 do 399 są zwracane do aplikacji.If AllowAutoRedirect is set to false, all HTTP responses with an HTTP status code from 300 to 399 are returned to the application.

Nagłówek autoryzacji jest wyczyszczony w obszarze Automatyczne przekierowania, a program obsługi automatycznie próbuje ponownie przeprowadzić uwierzytelnienie w przekierowanej lokalizacji.The Authorization header is cleared on auto-redirects and the handler automatically tries to re-authenticate to the redirected location. W rzeczywistości oznacza to, że aplikacja nie może umieścić niestandardowych informacji o uwierzytelnianiu w nagłówku autoryzacji, jeśli jest możliwe przeprowadzenie przekierowania.In practice, this means that an application can't put custom authentication information into the Authorization header if it is possible to encounter redirection. Zamiast tego aplikacja musi zaimplementować i zarejestrować niestandardowy moduł uwierzytelniania.Instead, the application must implement and register a custom authentication module.

Uwaga

Po ustawieniu na true, .NET Framework będzie podążać za przekierowaniami nawet wtedy, gdy nastąpi przekierowanie do identyfikatora URI http z identyfikatora URI https. AllowAutoRedirectWith AllowAutoRedirect set to true, the .NET Framework will follow redirections even when being redirected to an HTTP URI from an HTTPS URI. .NET Core w wersji 1,0, 1,1 i 2,0 nie będzie podążać za przekierowaniem z protokołu HTTPS AllowAutoRedirect do protokołu HTTP true, nawet jeśli jest ustawiony na..NET Core versions 1.0, 1.1 and 2.0 will not follow a redirection from HTTPS to HTTP even if AllowAutoRedirect is set to true.

Dotyczy