HttpWebRequest.PreAuthenticate Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.Requests.dll

Zdroj:

HttpWebRequest.cs

Získá nebo nastaví hodnotu, která určuje, zda se má odeslat autorizační hlavička s požadavkem.

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

public override bool PreAuthenticate { get; set; }

member this.PreAuthenticate : bool with get, set

Public Overrides Property PreAuthenticate As Boolean

Hodnota vlastnosti

Boolean

trueodeslání hlavičky autorizace HTTP s požadavky po provedení ověřování; v opačném případě . false Výchozí hodnota je false.

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.

Jakmile se požadavek klienta na konkrétního uživatele Uri úspěšně ověří a truePreAuthenticate zadá se přihlašovací údaje, autorizační hlavička se odešle s každou žádostí, Uri která odpovídá konkrétnímu Uri lomítku. Pokud se tedy požadavek klienta úspěšně ověřil pro konkrétního Uri uživatele, který obsahuje následující:

http://www.contoso.com/firstpath/

Potom se autorizační hlavička pro předběžné ověření odešle s každým požadavkem na některou z následujících Uri instancí:

http://www.contoso.com/firstpath/

http://www.contoso.com/firstpath/default

http://www.contoso.com/firstpath/default.html

http://www.contoso.com/firstpath/sample.html

Hlavička Autorizace se však neodesílají s požadavky na žádnou z následujících Uri instancí:

http://www.contoso.com/

http://www.contoso.com/firstpath

http://www.contoso.com/secondpath/

http://www.contoso.com/firstpath/thirdpath/

Pokud se požadavek klienta na konkrétní určitou Uri instanci úspěšně neověří, použije požadavek standardní ověřovací postupy.

S výjimkou prvního požadavku určuje vlastnost, PreAuthenticate zda se mají odesílat ověřovací informace s dalšími požadavky na Uri požadavek, který odpovídá konkrétnímu Uri lomítku až do posledního lomítka, aniž by server čekal na výzvu.

Následující dialog mezi klientem a serverem znázorňuje účinek této vlastnosti. V dialogovém okně se předpokládá, že se používá základní ověřování.

PreAuthenticate je false:

Klient: GET someUrl

Server: 401 WWW-Authenticate Basic

Klient: GET s autorizačními hlavičkami

Server: 200 OK

Klient: GET someUrl

Server: 401 WWW-Authenticate Basic

Klient: GET s autorizačními hlavičkami

Server: 200 OK

PreAuthenticate je true:

Klient: GET someUrl

Server: 401 WWW-Authenticate Basic

Klient: GET s autorizačními hlavičkami

Server: 200 OK

Klient: GET someUrl s autorizačními hlavičkami

Pokud schéma ověřování nepodporuje předběžné ověření, hodnota této vlastnosti se ignoruje.