AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Método

Referência

Definição

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origem:: AuthenticationManager.cs

Origem:: AuthenticationManager.cs

Origem:: AuthenticationManager.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

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

Compartilhar via