HttpWebRequest.PreAuthenticate Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
true
, um einen HTTP-Autorisierungsheader mit Anforderungen zu senden, nachdem die Authentifizierung stattgefunden hat; false
andernfalls . Der Standardwert lautet false
.
Hinweise
Nachdem eine Clientanforderung für eine bestimmte Uri Anforderung erfolgreich authentifiziert wurdetrue
, PreAuthenticate wird der Autorisierungsheader mit jeder Anforderung Uri gesendet, die dem spezifischen Uri bis zum letzten Schrägstrich entspricht. Wenn sich die Clientanforderung also erfolgreich bei einer bestimmten Uri 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 für 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 eine Uri gesendet werden sollen, die dem spezifischen Uri bis zum letzten Schrägstrich entspricht, ohne darauf warten zu müssen, vom Server herausforderbar 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 die Vorauthentifizierung nicht unterstützt, wird der Wert dieser Eigenschaft ignoriert.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für