HttpClientHandler.AllowAutoRedirect Vlastnost

Definice

Obor názvů:

System.Net.Http

Sestavení:

netstandard.dll, System.Net.Http.dll

Zdroj:

HttpClientHandler.cs

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

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 postupovat podle odpovědí přesměrování; jinak false. Výchozí hodnota je true.

Poznámky

Nastavte AllowAutoRedirect , 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, vrátí se do aplikace všechny odpovědi HTTP 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 obslužná rutina se automaticky pokusí znovu ověřit v přesměrované lokalitě. Žádné další hlavičky nejsou vymazány. 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.

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

Poznámka:

V .NET Core a .NET 5 a novějších verzích nastavení AllowAutoRedirecttruenepovoluje automatické přesměrování na identifikátor URI HTTP z identifikátoru URI HTTPS. Takové (zabezpečené a nezabezpečené) přesměrování se řídí pouze v rozhraní .NET Framework.