HttpWebRequest.PreAuthenticate Propriété

Définition

Obtient ou définit une valeur indiquant si un en-tête d'autorisation doit être envoyé 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é

true pour envoyer un en-tête d’autorisation HTTP avec des requêtes après l’authentification ; sinon, false. Par défaut, il s’agit de false.

Remarques

Une fois qu’une demande cliente adressée à un spécifique Uri a été 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 demande à toute Uri demande qui correspond au spécifique Uri jusqu’à la dernière barre oblique. Par conséquent, si la demande cliente s’est correctement authentifiée auprès d’un spécifique Uri qui contient les éléments suivants :

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

Ensuite, l’en-tête Authorization 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 Authorization n’est pas envoyé avec des requêtes à 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 cliente adressée à un spécifique Uri n’est pas correctement authentifiée, 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 que le serveur les conteste.

Le dialogue suivant 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 les 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.

S’applique à