Compartir por


AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Método

Definición

Precaución

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

Autentica previamente una solicitud.

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}")]
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
[<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
Public Shared Function PreAuthenticate (request As WebRequest, credentials As ICredentials) As Authorization

Parámetros

request
WebRequest

Solicitud a un recurso de Internet.

credentials
ICredentials

Credenciales asociadas a la solicitud.

Devoluciones

Instancia de la Authorization clase si la solicitud se puede autenticar previamente; de lo contrario, null. Si credentials es null, este método devuelve null.

Atributos

Excepciones

Solo .NET Core y .NET 5+: en todos los casos.

request es null.

Comentarios

Si el módulo de autenticación puede autenticar previamente la solicitud, el PreAuthenticate método devuelve una instancia de autenticación y envía la información de autorización al servidor de forma preventiva en lugar de esperar a que el recurso emita un desafío. Este comportamiento se describe en la sección 3.3 de RFC 2617 (Autenticación HTTP: Autenticación HTTP: Autenticación básica y implícita de acceso). Los módulos de autenticación que admiten la autenticación previa permiten a los clientes mejorar la eficacia del servidor evitando viajes de ida y vuelta adicionales causados por desafíos de autenticación.

Los módulos de autorización que pueden autenticar previamente las solicitudes establecen la IAuthenticationModule.CanPreAuthenticate propiedad en true.

Se aplica a