HttpWebRequest.PreAuthenticate Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Overrides Property PreAuthenticate As BooleanValore della proprietà
true inviare un'intestazione di autorizzazione HTTP con richieste dopo l'autenticazione; in caso contrario, false. Il valore predefinito è false.
Commenti
Cautela
WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.
Dopo l'autenticazione di una richiesta client a un Uri specifico, se PreAuthenticate viene true e le credenziali vengono fornite, l'intestazione Autorizzazione viene inviata con ogni richiesta a qualsiasi Uri che corrisponde al Uri specifico fino all'ultima barra. Pertanto, se la richiesta client è stata autenticata correttamente in un Uri specifico che contiene quanto segue:
http://www.contoso.com/firstpath/
L'intestazione di autorizzazione per la preautenticazione viene quindi inviata con ogni richiesta a una delle istanze di Uri seguenti:
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 a una delle istanze di Uri seguenti:
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 un Uri specifico non viene autenticata correttamente, la richiesta usa procedure di autenticazione standard.
Ad eccezione della prima richiesta, la proprietà PreAuthenticate indica se inviare informazioni di autenticazione con richieste successive a un Uri che corrisponde alla specifica Uri 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.
