AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Pré-autentica um pedido.
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.AuthorizationPublic Shared Function PreAuthenticate (request As WebRequest, credentials As ICredentials) As AuthorizationParâmetros
- request
- WebRequest
Um pedido para um recurso na internet.
- credentials
- ICredentials
As credenciais associadas ao pedido.
Devoluções
Uma instância da Authorization classe se o pedido puder ser pré-autenticado; caso contrário, null. Se credentials for null, este método devolve null.
Exceções
.NET Core e .NET 5+ apenas: Em todos os casos.
request é null.
Observações
Se o módulo de autenticação conseguir pré-autenticar o pedido, o PreAuthenticate método devolve uma instância de Autenticação e envia a informação de autorização para o servidor preventivamente, em vez de esperar que o recurso emita um desafio. Este comportamento está descrito na secção 3.3 do RFC 2617 (Autenticação HTTP: Autenticação de Acesso Básico e Digest). Os módulos de autenticação que suportam a pré-autenticação permitem aos clientes melhorar a eficiência do servidor ao evitar viagens extra de ida e volta causadas por desafios de autenticação.
Módulos de autorização que podem pré-autenticar pedidos definem a IAuthenticationModule.CanPreAuthenticate propriedade para true.