AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.Requests.dll

Zdroj:

AuthenticationManager.cs

Upozornění

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

Předběžně se žádost ověří.

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

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

Parametry

request

WebRequest

Požadavek na internetový prostředek.

credentials

ICredentials

Přihlašovací údaje přidružené k požadavku.

Návraty

Authorization

Instance Authorization třídy, pokud je možné požadavek předběžně autorizovat; v opačném případě null. Pokud credentials je null, vrátí tato metoda nullhodnotu .

Atributy

ObsoleteAttribute

Výjimky

PlatformNotSupportedException

Pouze .NET Core a .NET 5+: Ve všech případech.

ArgumentNullException

request je null.

Poznámky

Pokud ověřovací modul může požadavek předem ověřit, PreAuthenticate metoda vrátí instanci ověřování a odešle informace o autorizaci na server předběžně místo čekání na vystavení výzvy prostředkem. Toto chování je popsáno v části 3.3 dokumentu RFC 2617 (Ověřování HTTP: základní ověřování a ověřování přístupu hodnotou hash). Ověřovací moduly, které podporují předběžné ověřování, umožňují klientům zlepšit efektivitu serveru tím, že se vyhýbají dalším odezvám způsobeným problémy s ověřováním.

Autorizační moduly, které můžou požadavky předem ověřovat, nastaví IAuthenticationModule.CanPreAuthenticate vlastnost na true.