AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Méthode

Définition

Espace de noms:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

Préauthentifie une requête.

public:
 static System::Net::Authorization ^ PreAuthenticate(System::Net::WebRequest ^ request, System::Net::ICredentials ^ credentials);
public static System.Net.Authorization PreAuthenticate(System.Net.WebRequest request, System.Net.ICredentials credentials);
static member PreAuthenticate : System.Net.WebRequest * System.Net.ICredentials -> System.Net.Authorization
Public Shared Function PreAuthenticate (request As WebRequest, credentials As ICredentials) As Authorization

Paramètres

request
WebRequest

Demande à une ressource Internet.

credentials
ICredentials

Informations d’identification associées à la requête.

Retours

Authorization

Instance de la Authorization classe si la requête peut être préauthentifiée ; sinon, null. Si credentials c’est nullle cas, cette méthode retourne null.

Exceptions

PlatformNotSupportedException

.NET Core et .NET 5+ uniquement : dans tous les cas.

ArgumentNullException

request a la valeur null.

Remarques

Si le module d’authentification peut préauthentifier la requête, la PreAuthenticate méthode retourne une instance d’authentification et envoie les informations d’autorisation au serveur de manière préemptive au lieu d’attendre que la ressource émette un défi. Ce comportement est décrit dans la section 3.3 de RFC 2617 (Authentification HTTP : Authentification de base et d’accès Digest). Les modules d’authentification qui prennent en charge la pré-authentification permettent aux clients d’améliorer l’efficacité du serveur en évitant les allers-retours supplémentaires causés par les défis d’authentification.

Les modules d’autorisation qui peuvent préauthentifier les demandes définissent la IAuthenticationModule.CanPreAuthenticate propriété sur true.

S’applique à