AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Méthode

Référence

Définition

Espace de noms:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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.

Attention

The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.

Pré-authentifie une demande.

public:
 static System::Net::Authorization ^ PreAuthenticate(System::Net::WebRequest ^ request, System::Net::ICredentials ^ credentials);

[System.Obsolete("The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.", DiagnosticId="SYSLIB0009", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
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);

[<System.Obsolete("The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.", DiagnosticId="SYSLIB0009", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member PreAuthenticate : System.Net.WebRequest * System.Net.ICredentials -> System.Net.Authorization

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 demande.

Retours

Authorization

Instance de la classe Authorization si la demande peut être pré-authentifiée ; sinon, null. Si credentials est null, cette méthode retourne null.

Attributs: ObsoleteAttribute

Exceptions

PlatformNotSupportedException

.NET Core et .NET 5 (et versions ultérieures) uniquement : Dans tous les cas.

ArgumentNullException

request a la valeur null.

Remarques

Si le module d’authentification peut préauthentifier la demande, 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 Digest Access). 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é truesur .

S’applique à