AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
.