Condividi tramite


AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Metodo

Definizione

Attenzione

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

Preautentica una richiesta.

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}")]
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.Authorization
[<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

Parametri

request
WebRequest

Richiesta a una risorsa Internet.

credentials
ICredentials

Credenziali associate alla richiesta.

Restituisce

Istanza della Authorization classe se la richiesta può essere preautenticata; in caso contrario, null. Se credentials è null, questo metodo restituisce null.

Attributi

Eccezioni

Solo .NET Core e .NET 5+: in tutti i casi.

request è null.

Commenti

Se il modulo di autenticazione può preautenticare la richiesta, il PreAuthenticate metodo restituisce un'istanza di autenticazione e invia le informazioni di autorizzazione al server in modo preemptive anziché attendere che la risorsa invii una richiesta di verifica. Questo comportamento è descritto nella sezione 3.3 di RFC 2617 (autenticazione HTTP: autenticazione di base e di accesso digest). I moduli di autenticazione che supportano la preautenticazione consentono ai client di migliorare l'efficienza del server evitando round trip aggiuntivi causati da problemi di autenticazione.

I moduli di autorizzazione che possono preautenticare le richieste impostano la IAuthenticationModule.CanPreAuthenticate proprietà su true.

Si applica a