HttpWebRequest.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 żądanie powinno być zgodne z odpowiedziami przekierowania.
public:
virtual property bool AllowAutoRedirect { bool get(); void set(bool value); };public:
property bool AllowAutoRedirect { bool get(); void set(bool value); };public virtual bool AllowAutoRedirect { get; set; }public bool AllowAutoRedirect { get; set; }member this.AllowAutoRedirect : bool with get, setPublic Overridable Property AllowAutoRedirect As BooleanPublic Property AllowAutoRedirect As BooleanWartość właściwości
true, jeśli żądanie powinno automatycznie śledzić odpowiedzi przekierowania z zasobu internetowego; w przeciwnym razie false. Wartość domyślna to true.
Przykłady
Poniższy przykład kodu używa właściwości AllowAutoRedirect, aby umożliwić żądaniu obserwowanie odpowiedzi przekierowania.
// Create a new HttpWebRequest Object to the mentioned URL.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest->MaximumAutomaticRedirections = 1;
myHttpWebRequest->AllowAutoRedirect = true;
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );
// Create a new HttpWebRequest Object to the mentioned URL.
HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
myHttpWebRequest.MaximumAutomaticRedirections=1;
myHttpWebRequest.AllowAutoRedirect=true;
HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();
'This method creates a new HttpWebRequest Object to the mentioned URL.
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
myHttpWebRequest.MaximumAutomaticRedirections = 1
myHttpWebRequest.AllowAutoRedirect = True
Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
Uwagi
Ostrożność
WebRequest, HttpWebRequest, ServicePointi WebClient są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Ustaw AllowAutoRedirect na true, jeśli chcesz, aby żądanie automatycznie śledziło nagłówki przekierowania HTTP do nowej lokalizacji zasobu. Maksymalna liczba przekierowań do obserwowanych jest ustawiana przez właściwość MaximumAutomaticRedirections.
Jeśli AllowAutoRedirect jest ustawiona na false, wszystkie odpowiedzi z kodem stanu HTTP z zakresu od 300 do 399 są zwracane do aplikacji.
Nagłówek autoryzacji jest czyszczone po automatycznych przekierowaniach i HttpWebRequest automatycznie próbuje ponownie uwierzytelnić się w przekierowanej lokalizacji. 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. Klasa System.Net.AuthenticationManager i powiązana są używane do implementowania niestandardowego modułu uwierzytelniania. Metoda AuthenticationManager.Register rejestruje niestandardowy moduł uwierzytelniania.
