HttpClientHandler.AllowAutoRedirect Vlastnost

Definice

Obor názvů:

System.Net.Http

Sestavení:

System.Net.Http.dll

Zdroj:

HttpClientHandler.cs

Získá nebo nastaví hodnotu, která označuje, zda obslužná rutina má následovat přesměrování odpovědi.

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

Hodnota vlastnosti

Boolean

true pokud by obslužná rutina měla sledovat odpovědi přesměrování; jinak false. Výchozí hodnota je true.

Poznámky

Nastavte AllowAutoRedirect na, true pokud chcete, aby obslužná rutina automaticky sledovala hlavičky přesměrování HTTP do nového umístění prostředku. Maximální počet přesměrování, která se mají sledovat, je nastaven vlastností MaxAutomaticRedirections .

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

U automatických přesměrování se vymaže hlavička Autorizace a obslužná rutina se automaticky pokusí znovu ověřit přesměrované umístění. Žádná další záhlaví nejsou vymazána. V praxi to znamená, že aplikace nemůže vložit vlastní ověřovací informace do hlavičky autorizace, pokud je možné narazit na přesměrování. Místo toho musí aplikace implementovat a zaregistrovat vlastní ověřovací modul.

Pokud používáte soubory cookie tak, že je výslovně přidáte do kolekce, nebudou Headers při přesměrování vymazány, protože obslužná rutina nemůže zjistit, pro jakou doménu je soubor cookie povolený. Pokud chcete napodobit chování prohlížeče, použijte CookieContainer třídu, která vám umožní určit cílovou doménu pro soubor cookie.

Poznámka

V AllowAutoRedirect nastavení na truebude rozhraní .NET Framework sledovat přesměrování i při přesměrování na identifikátor URI HTTP z identifikátoru URI HTTPS. .NET Core verze 1.0, 1.1 a 2.0 nesleduje přesměrování z HTTPS na HTTP, i když AllowAutoRedirect je nastavený na true.