AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Método

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

AuthenticationManager.cs

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

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

Uma solicitação para um recurso da Internet.

credentials

ICredentials

As credenciais associadas à solicitação.

Retornos

Authorization

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

ObsoleteAttribute

Exceções

PlatformNotSupportedException

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

ArgumentNullException

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