HttpWebRequest.PreAuthenticate Proprietà

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.Requests.dll

Origine:

HttpWebRequest.cs

Ottiene o imposta un valore che indica se inviare un'intestazione di autorizzazione con la richiesta.

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

Valore della proprietà

Boolean

true per inviare un'intestazione di autorizzazione HTTP con richieste dopo l'autenticazione; in caso contrario, false. Il valore predefinito è false.

Commenti

Dopo l'autenticazione di una richiesta client a una specificaUri, se PreAuthenticate è true e vengono specificate le credenziali, l'intestazione Authorization viene inviata con ogni richiesta a qualsiasi Uri oggetto corrispondente all'ultima barra.Uri Pertanto, se la richiesta client è stata autenticata correttamente in un oggetto specifico Uri che contiene quanto segue:

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

L'intestazione authorization per la preautenticazione viene quindi inviata con ogni richiesta a una delle istanze seguenti Uri :

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

Tuttavia, l'intestazione Authorization non viene inviata con richieste ad alcuna delle istanze seguenti Uri :

http://www.contoso.com/

http://www.contoso.com/firstpath

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

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

Se la richiesta client a una specifica Uri non viene autenticata correttamente, la richiesta utilizza procedure di autenticazione standard.

Ad eccezione della prima richiesta, la PreAuthenticate proprietà indica se inviare informazioni di autenticazione con richieste successive a un Uri oggetto che corrisponde all'ultima Uri barra fino all'ultima barra senza attendere che il server venga contestato.

La finestra di dialogo seguente tra client e server illustra l'effetto di questa proprietà. La finestra di dialogo presuppone che l'autenticazione di base sia in uso.

PreAuthenticate è false:

Client: GET someUrl

Server: 401 WWW-Authenticate Basic

Client: GET con intestazioni di autorizzazione

Server: 200 OK

Client: GET someUrl

Server: 401 WWW-Authenticate Basic

Client: GET con intestazioni di autorizzazione

Server: 200 OK

PreAuthenticate è true:

Client: GET someUrl

Server: 401 WWW-Authenticate Basic

Client: GET con intestazioni di autorizzazione

Server: 200 OK

Client: GET someUrl con intestazioni di autorizzazione

Se lo schema di autenticazione non supporta la preautenticazione, il valore di questa proprietà viene ignorato.