HttpWebRequest.PreAuthenticate Propriété

Définition

Espace de noms:

System.Net

Assemblys:

netstandard.dll, System.Net.Requests.dll

Source:

HttpWebRequest.cs

Obtient ou définit une valeur qui indique s’il faut envoyer un en-tête d’autorisation avec la requête.

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

Valeur de propriété

Boolean

true pour envoyer un en-tête d’autorisation HTTP avec des demandes après l’authentification ; sinon, false. La valeur par défaut est false.

Remarques

Prudence

WebRequest, , HttpWebRequestServicePointet sont obsolètes, et WebClient vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

Une fois qu’une demande cliente adressée à un client spécifique Uri est correctement authentifiée, s’il PreAuthenticatetrue s’agit d’informations d’identification fournies, l’en-tête d’autorisation est envoyé avec chaque requête correspondant à Uri la dernière barre oblique spécifique Uri jusqu’à la dernière barre oblique. Par conséquent, si la demande du client s’est authentifiée avec succès auprès d’un élément spécifique Uri qui contient les éléments suivants :

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

Ensuite, l’en-tête d’autorisation pour la pré-authentification est envoyé avec chaque requête à l’une des instances suivantes 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

Toutefois, l’en-tête d’autorisation n’est pas envoyé avec des demandes à l’une des instances suivantes Uri :

http://www.contoso.com/

http://www.contoso.com/firstpath

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

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

Si la demande du client à une requête spécifique Uri n’est pas authentifiée avec succès, la demande utilise des procédures d’authentification standard.

À l’exception de la première requête, la PreAuthenticate propriété indique s’il faut envoyer des informations d’authentification avec les demandes suivantes à un Uri qui correspond à la barre oblique spécifique Uri jusqu’à la dernière barre oblique sans attendre d’être contestée par le serveur.

La boîte de dialogue suivante entre le client et le serveur illustre l’effet de cette propriété. La boîte de dialogue suppose que l’authentification de base est en cours d’utilisation.

PreAuthenticate est false:

Client : GET someUrl

Serveur : 401 WWW-Authenticate De base

Client : GET avec en-têtes d’autorisation

Serveur : 200 OK

Client : GET someUrl

Serveur : 401 WWW-Authenticate De base

Client : GET avec en-têtes d’autorisation

Serveur : 200 OK

PreAuthenticate est true:

Client : GET someUrl

Serveur : 401 WWW-Authenticate De base

Client : GET avec en-têtes d’autorisation

Serveur : 200 OK

Client : GET someUrl avec en-têtes d’autorisation

Si le schéma d’authentification ne prend pas en charge la pré-authentification, la valeur de cette propriété est ignorée.