HttpWebRequest.PreAuthenticate Propriété

Définition

Espace de noms:

System.Net

Assembly:

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, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

Une fois qu’une demande cliente adressée à une Uri spécifique est correctement authentifiée, si PreAuthenticate est true et que les informations d’identification sont fournies, l’en-tête d’autorisation est envoyé avec chaque requête à n’importe quelle Uri qui correspond à la Uri spécifique 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 Uri spécifique 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 de Uri suivantes :

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 requêtes à l’une des instances de Uri suivantes :

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 à un Uri spécifique 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 propriété PreAuthenticate indique s’il faut envoyer des informations d’authentification avec des demandes ultérieures à un Uri qui correspond à la Uri spécifique jusqu’à la dernière barre oblique sans attendre qu’il soit contesté 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.