AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Requests.dll

Source:

AuthenticationManager.cs

Precaución

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

Realiza la autenticación previa de una solicitud.

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);

[<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

Una solicitud a un recurso de Internet.

credentials

ICredentials

Las credenciales asociadas a la solicitud.

Devoluciones

Authorization

Es una instancia de la clase Authorization si se puede realizar la autenticación previa de la solicitud; de lo contrario es null. Si credentials es null este método devuelve null.

Atributos

ObsoleteAttribute

Excepciones

PlatformNotSupportedException

.NET Core y .NET 5+ solo: En todos los casos.

ArgumentNullException

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 básica e implícita de acceso). Los módulos de autenticación que admiten la autenticación previa permiten a los clientes mejorar la eficiencia del servidor al evitar recorridos 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.