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, setPublic Overrides Property PreAuthenticate As BooleanEigenschaftswert
true um einen HTTP-Autorisierungsheader mit Anforderungen zu senden, nachdem die Authentifizierung stattgefunden hat; falseandernfalls . Der Standardwert ist false.
Hinweise
Nachdem eine Clientanforderung an eine bestimmte Uri Anforderung erfolgreich authentifiziert wurde, wenn true PreAuthenticate und Anmeldeinformationen angegeben werden, wird der Autorisierungsheader mit jeder Anforderung an jede Uri Anforderung gesendet, die dem spezifischen Uri schrägen Schrägstrich entspricht. Wenn die Clientanforderung also erfolgreich bei einem bestimmten Uri authentifiziert wurde, der Folgendes enthält:
http://www.contoso.com/firstpath/
Anschließend wird der Autorisierungsheader für die Vorabauthentication 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/
Wenn die Clientanforderung an eine bestimmte Uri Anforderung nicht erfolgreich authentifiziert wird, 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ägen Schrägstrich entspricht, ohne darauf zu warten, vom Server herausfordern zu müssen.
Das folgende Dialogfeld zwischen Client und Server veranschaulicht den Effekt 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 with Authorization Headers
Wenn das Authentifizierungsschema keine Vorautorisierung unterstützt, wird der Wert dieser Eigenschaft ignoriert.