HttpWebRequest.PreAuthenticate Tulajdonság

Definíció

Névtér:

System.Net

Szerelvények:

netstandard.dll, System.Net.Requests.dll

Forrás:

HttpWebRequest.cs

Lekéri vagy beállít egy értéket, amely jelzi, hogy küld-e engedélyezési fejlécet a kéréssel.

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

Tulajdonság értéke

Boolean

trueHTTP-engedélyezési fejléc küldése kérésekkel a hitelesítés után; egyéb esetben. false Az alapértelmezett érték a false.

Megjegyzések

Figyelmeztetés

WebRequest, HttpWebRequest, ServicePointés WebClient elavultak, és nem szabad új fejlesztésre használni őket. A HttpClient használható helyette.

Az adott Uri ügyfélkérés sikeres hitelesítése után, ha PreAuthenticate igen true , és a hitelesítő adatok meg vannak adva, a rendszer minden kéréssel együtt elküldi az engedélyezési fejlécet minden olyan Uri kéréshez, amely megfelel az adottnak Uri az utolsó perjelig. Ha tehát az ügyfélkérés sikeresen hitelesítve van egy olyan konkrétan Uri , amely a következőket tartalmazza:

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

Ezután a rendszer minden kéréssel elküldi az előhitelesítés engedélyezési fejlécét a következő Uri példányok bármelyikének:

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

Az engedélyezési fejlécet azonban a rendszer nem küldi el kérésekkel a következő Uri példányok egyikének sem:

http://www.contoso.com/

http://www.contoso.com/firstpath

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

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

Ha egy adott Uri ügyfélkérés hitelesítése nem sikerült, a kérés szabványos hitelesítési eljárásokat használ.

Az első kérés kivételével a PreAuthenticate tulajdonság azt jelzi, hogy a hitelesítési adatokat a későbbi kérésekkel együtt küldi-e el egy Uri olyannak, amely megfelel az adottnak Uri az utolsó perjelig, anélkül, hogy várnia kellene, hogy a kiszolgáló megtámadja.

Az ügyfél és a kiszolgáló közötti alábbi párbeszédpanel a tulajdonság hatását mutatja be. A párbeszédpanel feltételezi, hogy az alapszintű hitelesítés használatban van.

PreAuthenticate a következő false:

Ügyfél: GET someUrl

Kiszolgáló: 401 WWW-Authenticate Basic

Ügyfél: GET engedélyezési fejlécekkel

Kiszolgáló: 200 OK

Ügyfél: GET someUrl

Kiszolgáló: 401 WWW-Authenticate Basic

Ügyfél: GET engedélyezési fejlécekkel

Kiszolgáló: 200 OK

PreAuthenticate a következő true:

Ügyfél: GET someUrl

Kiszolgáló: 401 WWW-Authenticate Basic

Ügyfél: GET engedélyezési fejlécekkel

Kiszolgáló: 200 OK

Ügyfél: GET someUrl engedélyezési fejlécekkel

Ha a hitelesítési séma nem támogatja az előhitelesítést, a tulajdonság értéke figyelmen kívül lesz hagyva.