AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origine:: AuthenticationManager.cs

Origine:: AuthenticationManager.cs

Origine:: AuthenticationManager.cs

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

Authorization

Un'istanza della classe Authorization se la richiesta può essere preautenticata. In caso contrario, null. Se credentials è null, questo metodo restituisce null.

Attributi: ObsoleteAttribute

Eccezioni

PlatformNotSupportedException

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

ArgumentNullException

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