HttpWebRequest.AllowAutoRedirect Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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:
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, set
Public Overridable Property AllowAutoRedirect As Boolean
Public Property AllowAutoRedirect As Boolean
Hodnota vlastnosti
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
, ServicePoint
a 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.