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.
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, setPublic Overrides Property PreAuthenticate As BooleanEigenschaftswert
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.
