HttpWebRequest.PreAuthenticate Proprietà

Definizione

Spazio dei nomi:

System.Net

Assembly:

netstandard.dll, 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

Cautela

WebRequest ServicePoint, HttpWebRequest, e WebClient sono obsoleti e non è consigliabile usarli per il nuovo sviluppo. Utilizzare invece HttpClient.

Dopo che una richiesta client a uno specifico Uri è stata autenticata correttamente, se PreAuthenticate è true e vengono specificate le credenziali, l'intestazione Authorization viene inviata con ogni richiesta a qualsiasi Uri che corrisponda Uri all'ultima barra fino all'ultima barra. 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 uno specifico Uri non viene autenticata correttamente, la richiesta usa 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 venga richiesto dal server.

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.