HttpWebRequest.PreAuthenticate Eigenschaft

Definition

Namespace:

System.Net

Assemblys:

netstandard.dll, System.Net.Requests.dll

Quelle:

HttpWebRequest.cs

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Autorisierungsheader mit der Anforderung gesendet werden soll.

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

Eigenschaftswert

Boolean

trueeinen HTTP-Autorisierungsheader mit Anforderungen zu senden, nachdem die Authentifizierung erfolgt ist; andernfalls . false Der Standardwert lautet false.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

Nachdem eine Clientanforderung an eine bestimmte Uri Anforderung erfolgreich authentifiziert wurde, wenn PreAuthenticate dies der Fall ist true und Anmeldeinformationen angegeben werden, wird der Autorisierungsheader mit jeder Anforderung an alle Uri Anforderungen gesendet, die dem spezifischen Uri Schrägstrich bis zum letzten Schrägstrich entsprechen. Wenn sich die Clientanforderung also erfolgreich bei einer bestimmten Uri Anforderung authentifiziert hat, die Folgendes enthält:

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

Anschließend wird der Autorisierungsheader für die Vorauthentifizierung mit jeder Anforderung an eine der folgenden Uri Instanzen gesendet:

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

Der Autorisierungsheader wird jedoch nicht mit Anforderungen an eine der folgenden Uri Instanzen gesendet:

http://www.contoso.com/

http://www.contoso.com/firstpath

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

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

Wenn die Clientanforderung an eine bestimmte Uri Anforderung nicht erfolgreich authentifiziert wurde, verwendet die Anforderung standardauthentifizierungsverfahren.

Mit Ausnahme der ersten Anforderung gibt die PreAuthenticate Eigenschaft an, ob Authentifizierungsinformationen mit nachfolgenden Anforderungen an einen Uri Gesendet werden sollen, der dem spezifischen Uri Schrägstrich entspricht, ohne darauf zu warten, vom Server herauszufordern.

Das folgende Dialogfeld zwischen Client und Server veranschaulicht die Auswirkung dieser Eigenschaft. Im Dialogfeld wird davon ausgegangen, dass die Standardauthentifizierung verwendet wird.

PreAuthenticate ist false:

Client: GET someUrl

Server: 401 WWW-Authenticate Basic

Client: GET mit Autorisierungsheadern

Server: 200 OK

Client: GET someUrl

Server: 401 WWW-Authenticate Basic

Client: GET mit Autorisierungsheadern

Server: 200 OK

PreAuthenticate ist true:

Client: GET someUrl

Server: 401 WWW-Authenticate Basic

Client: GET mit Autorisierungsheadern

Server: 200 OK

Client: GET someUrl mit Autorisierungsheadern

Wenn das Authentifizierungsschema keine Vorauthentifizierung unterstützt, wird der Wert dieser Eigenschaft ignoriert.