Freigeben über


AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Methode

Definition

Achtung

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

Führt die Vorauthentifizierung einer Anforderung durch.

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

Parameter

request
WebRequest

Eine Anforderung an eine Internetressource.

credentials
ICredentials

Die anmeldeinformationen, die der Anforderung zugeordnet sind.

Gibt zurück

Eine Instanz der Authorization-Klasse, wenn die Anforderung vorauthentifiziert werden kann, andernfalls null. Wenn credentials gleich null ist, gibt die Methode null zurück.

Attribute

Ausnahmen

Nur .NET Core und .NET 5 und höher: In allen Fällen.

request ist null

Hinweise

Wenn das Authentifizierungsmodul die Anforderung vorab authentifizieren kann, gibt die PreAuthenticate Methode eine Authentifizierungsinstanz zurück und sendet die Autorisierungsinformationen vorab an den Server, anstatt darauf zu warten, dass die Ressource eine Anforderung ausgibt. Dieses Verhalten wird in Abschnitt 3.3 von RFC 2617 (HTTP-Authentifizierung: Standard- und Digestzugriffsauthentifizierung) beschrieben. Authentifizierungsmodule, die die Vorauthentifizierung unterstützen, ermöglichen Es Clients, die Servereffizienz zu verbessern, indem zusätzliche Roundtrips vermieden werden, die durch Authentifizierungsherausforderungen verursacht werden.

Autorisierungsmodule, die Anforderungen vorab authentifizieren können, legen die IAuthenticationModule.CanPreAuthenticate -Eigenschaft auf fest true.

Gilt für: