HttpWebRequest.AllowAutoRedirect Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.Requests.dll

Zdroj:

HttpWebRequest.cs

Získá nebo nastaví hodnotu, která určuje, jestli má požadavek postupovat podle odpovědí přesměrování.

public:
 virtual property bool AllowAutoRedirect { bool get(); void set(bool value); };

public virtual bool AllowAutoRedirect { get; set; }

member this.AllowAutoRedirect : bool with get, set

Public Overridable Property AllowAutoRedirect As Boolean

Hodnota vlastnosti

Boolean

true, pokud by požadavek měl automaticky sledovat odpovědi přesměrování z internetového prostředku; jinak false. Výchozí hodnota je true.

Příklady

Následující příklad kódu používá vlastnost AllowAutoRedirect, která umožňuje požadavku sledovat odpovědi přesměrování.

// 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)

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Pokud chcete, aby požadavek automaticky sledoval hlavičky přesměrování HTTP do nového umístění prostředku, nastavte AllowAutoRedirect na true. Maximální počet přesměrování, které se mají sledovat, je nastaven vlastností MaximumAutomaticRedirections.

Pokud je AllowAutoRedirect nastavena na false, vrátí se do aplikace všechny odpovědi se stavovým kódem HTTP od 300 do 399.

Autorizační hlavička se vymaže při automatickém přesměrování a HttpWebRequest se automaticky pokusí znovu ověřit přesměrované umístění. V praxi to znamená, že aplikace nemůže do hlavičky Autorizace vložit vlastní ověřovací informace, pokud je možné narazit na přesměrování. Místo toho musí aplikace implementovat a zaregistrovat vlastní ověřovací modul. K implementaci vlastního ověřovacího modulu se používají System.Net.AuthenticationManager a související třída. Metoda AuthenticationManager.Register zaregistruje vlastní ověřovací modul.