Lire en anglais

Partager via


AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Méthode

Définition

Attention

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

Pré-authentifie une demande.

C#
[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);
C#
public static System.Net.Authorization? PreAuthenticate(System.Net.WebRequest request, System.Net.ICredentials credentials);
C#
public static System.Net.Authorization PreAuthenticate(System.Net.WebRequest request, System.Net.ICredentials credentials);

Paramètres

request
WebRequest

Demande à une ressource Internet.

credentials
ICredentials

Informations d’identification associées à la demande.

Retours

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

Exceptions

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

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éventive au lieu d’attendre que la ressource émette un défi. Ce comportement est décrit dans la section 3.3 de la 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 des allers-retours supplémentaires causés par des problèmes d’authentification.

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

S’applique à

Produit Versions (Obsolète)
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 9 (5, 6, 7, 8)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1