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

Parametri

request
WebRequest

Richiesta a una risorsa Internet.

credentials
ICredentials

Credenziali associate alla richiesta.

Restituisce

Un'istanza della classe Authorization 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ò preutenticare 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 verifichi una richiesta. Questo comportamento è descritto nella sezione 3.3 di RFC 2617 (autenticazione HTTP: autenticazione DI base e di accesso al digest). I moduli di autenticazione che supportano la preutenticazione consentono ai client di migliorare l'efficienza del server evitando altri round trip causati da problemi di autenticazione.

Moduli di autorizzazione che possono preutenticare le richieste impostare la IAuthenticationModule.CanPreAuthenticate proprietà su true.

Si applica a