HttpWebRequest.PreAuthenticate Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

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

true odeslat autorizační hlavičku HTTP s požadavky po ověření; jinak 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í Uri úspěšně ověří, PreAuthenticatetrue a zadá se přihlašovací údaje, autorizační hlavička se odešle s každou žádostí do libovolného Uri, který odpovídá konkrétnímu Uri až do posledního lomítka. Pokud se tedy požadavek klienta úspěšně ověřil pro konkrétní Uri, 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ždou žádostí do libovolné 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í Uri úspěšně neověří, použije požadavek standardní ověřovací postupy.

S výjimkou prvního požadavku vlastnost PreAuthenticate označuje, jestli se mají odesílat ověřovací informace s dalšími požadavky na Uri, který odpovídá konkrétnímu Uri 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.