HttpWebRequest.PreAuthenticate Eigenschaft

Definition

Namespace:

System.Net

Assembly:

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

true, einen HTTP-Autorisierungsheader mit Anforderungen zu senden, nachdem die Authentifizierung erfolgt ist; andernfalls false. Der Standardwert ist 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 erfolgreich authentifiziert wurde, wenn PreAuthenticatetrue und Anmeldeinformationen angegeben werden, wird der Autorisierungsheader mit jeder Anforderung an alle Uri gesendet, die dem spezifischen Uri bis zum letzten Schrägstrich entsprechen. Wenn sich die Clientanforderung also erfolgreich bei einem bestimmten Uri authentifiziert hat, der 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 nicht erfolgreich authentifiziert wird, verwendet die Anforderung standardauthentifizierungsverfahren.

Mit Ausnahme der ersten Anforderung gibt die eigenschaft PreAuthenticate an, ob Authentifizierungsinformationen mit nachfolgenden Anforderungen an eine Uri gesendet werden sollen, die dem spezifischen Uri bis zum letzten Schrägstrich entspricht, ohne darauf zu warten, vom Server herausfordern zu müssen.

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.