HttpWebRequest.PreAuthenticate Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob mit der Anforderung ein Autorisierungsheader gesendet wird, oder legt diesen fest.Gets or sets a value that indicates whether to send an Authorization header with the request.

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 nach der Authentifizierung einen Authorization-HTTP-Header mit Anforderungen zu senden, andernfalls false.true to send an HTTP Authorization header with requests after authentication has taken place; otherwise, false. Die Standardeinstellung ist false.The default is false.

Hinweise

Wenn eine Client Anforderung an eine bestimmte Uri erfolgreich authentifiziert wurde, wenn PreAuthenticate true ist und Anmelde Informationen bereitgestellt werden, wird der Autorisierungs Header mit jeder Anforderung an alle Uri gesendet, die mit der bestimmten Uri bis zum letzten Forward übereinstimmen. ßen.After a client request to a specific Uri is successfully authenticated, if PreAuthenticate is true and credentials are supplied, the Authorization header is sent with each request to any Uri that matches the specific Uri up to the last forward slash. Wenn sich die Client Anforderung für eine bestimmte Uri authentifiziert hat, die Folgendes enthält:So if the client request successfully authenticated to a specific Uri that contains the following:

http://www.contoso.com/firstpath/

Anschließend wird der Autorisierungs Header für die Vorauthentifizierung mit jeder Anforderung an eine der folgenden Uri Instanzen gesendet:Then the Authorization header for preauthentication is sent with each request to any of the following Uri instances:

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 Autorisierungs Header wird jedoch nicht mit Anforderungen an eine der folgenden Uri Instanzen gesendet:However, the Authorization header is not sent with requests to any of the following Uri instances:

http://www.contoso.com/

http://www.contoso.com/firstpath

http://www.contoso.com/secondpath/

Wenn die Client Anforderung an einen bestimmten Uri nicht erfolgreich authentifiziert wird, verwendet die Anforderung Standard Authentifizierungs Prozeduren.If the client request to a specific Uri is not successfully authenticated, the request uses standard authentication procedures.

Mit Ausnahme der ersten Anforderung gibt die PreAuthenticate-Eigenschaft an, ob Authentifizierungsinformationen mit nachfolgenden Anforderungen an einen Uri gesendet werden sollen, der mit dem spezifischen Uri bis zum letzten Schrägstrich übereinstimmt, ohne dass darauf gewartet wird, dass die Servers.With the exception of the first request, the PreAuthenticate property indicates whether to send authentication information with subsequent requests to a Uri that matches the specific Uri up to the last forward slash without waiting to be challenged by the server.

Das folgende Dialogfeld zwischen Client und Server veranschaulicht die Auswirkung dieser Eigenschaft.The following dialog between client and server illustrates the effect of this property. Im Dialogfeld wird davon ausgegangen, dass die Standard Authentifizierung verwendet wird.The dialog assumes that basic authentication is in use.

PreAuthenticate ist false:PreAuthenticate is false:

Client: Get someurlClient: GET someUrl

Server: 401 www-authentifizieren BasicServer: 401 WWW-Authenticate Basic

Client: Mit Autorisierungs HeadernClient: GET with Authorization headers

Server: 200 OKServer: 200 OK

Client: Get someurlClient: GET someUrl

Server: 401 www-authentifizieren BasicServer: 401 WWW-Authenticate Basic

Client: Mit Autorisierungs HeadernClient: GET with Authorization headers

Server: 200 OKServer: 200 OK

PreAuthenticate ist true:PreAuthenticate is true:

Client: Get someurlClient: GET someUrl

Server: 401 www-authentifizieren BasicServer: 401 WWW-Authenticate Basic

Client: Mit Autorisierungs HeadernClient: GET with Authorization headers

Server: 200 OKServer: 200 OK

Client: Erhalten Sie eine someurl mit Autorisierungs Headern.Client: GET someUrl with Authorization headers

Wenn das Authentifizierungsschema die Vorauthentifizierung nicht unterstützt, wird der Wert dieser Eigenschaft ignoriert.If the authentication scheme does not support preauthentication, the value of this property is ignored.

Gilt für: