HttpWebRequest.PreAuthenticate Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Quelle:

HttpWebRequest.cs

Ruft einen Wert ab, der angibt, ob mit der Anforderung ein Autorisierungsheader gesendet wird, oder legt diesen fest.

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 , um nach der Authentifizierung einen HTTP-Autorisierungsheader mit Anforderungen zu senden; falseandernfalls . Der Standardwert lautet false.

Hinweise

Nachdem eine Clientanforderung an einen bestimmten Uri erfolgreich authentifiziert wurde, wird PreAuthenticatetrue der Autorisierungsheader mit jeder Anforderung Uri an jede Anforderung gesendet, die dem spezifischen Uri bis zum letzten Schrägstrich entspricht. Wenn also die Clientanforderung erfolgreich bei einer bestimmten Uri authentifiziert wurde, 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 einen bestimmten Uri nicht erfolgreich authentifiziert wurde, verwendet die Anforderung Standardauthentifizierungsverfahren.

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

Das folgende Dialogfeld zwischen Client und Server veranschaulicht die Auswirkungen 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.