Partilhar via


AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Método

Definição

Cuidado

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

Pré-autentica uma solicitação.

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

Parâmetros

request
WebRequest

Uma solicitação para um recurso da Internet.

credentials
ICredentials

As credenciais associadas à solicitação.

Retornos

Uma instância da classe Authorization se a solicitação puder ser pré-autenticada; caso contrário, null. Se credentials for null, esse método retornará null.

Atributos

Exceções

Somente .NET Core e .NET 5+: Em todos os casos.

request é null.

Comentários

Se o módulo de autenticação puder pré-autenticar a solicitação, o PreAuthenticate método retornará uma instância de Autenticação e enviará as informações de autorização para o servidor preventivamente em vez de aguardar que o recurso emita um desafio. Esse comportamento é descrito na seção 3.3 do RFC 2617 (Autenticação HTTP: Autenticação de Acesso Básica e Digest). Os módulos de autenticação que dão suporte à pré-autenticação permitem que os clientes melhorem a eficiência do servidor, evitando viagens de ida e volta extras causadas por desafios de autenticação.

Os módulos de autorização que podem pré-autenticar solicitações definem a IAuthenticationModule.CanPreAuthenticate propriedade como true.

Aplica-se a