HttpWebRequest.PreAuthenticate Vlastnost

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.Requests.dll

Zdroj:

HttpWebRequest.cs

Získá nebo nastaví hodnotu, která označuje, zda odeslat autorizační hlavičku 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í autorizační hlavičky HTTP s požadavky po ověření; v opačném případě . false Výchozí formát je false.

Poznámky

Po úspěšném ověření požadavku klienta na konkrétního Uri zákazníka, pokud PreAuthenticate jsou zadány přihlašovací údaje a jsou zadány hodnoty a true přihlašovací údaje, je hlavička Authorization odeslána s každým požadavkem, Uri který odpovídá konkrétnímu Uri až poslednímu lomítku. Pokud se tedy požadavek klienta úspěšně ověřil u konkrétního Uri požadavku, 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 některé 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 Authorization se ale 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 hodnotu úspěšně neověří, použije se standardní ověřovací postupy.

S výjimkou prvního požadavku vlastnost určuje, PreAuthenticate zda se mají ověřovací informace s následnými požadavky odeslat na Uri objekt, který odpovídá konkrétnímu Uri až poslednímu lomítku, aniž by čekal na výzvu serveru.

Následující dialogové okno mezi klientem a serverem ukazuje účinek této vlastnosti. Dialogové okno 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 je ignorována.