HttpWebRequest.PreAuthenticate Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setPublic Overrides Property PreAuthenticate As BooleanValeur de propriété
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.
