AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Methode

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Quelle:: AuthenticationManager.cs

Quelle:: AuthenticationManager.cs

Quelle:: AuthenticationManager.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Authorization

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: ObsoleteAttribute

Ausnahmen

PlatformNotSupportedException

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

ArgumentNullException

request ist null

Hinweise

Wenn das Authentifizierungsmodul die Anforderung vorab authentifizieren kann, gibt die PreAuthenticate Methode eine Authentifizierungs-instance zurück und sendet die Autorisierungsinformationen präventiv an den Server, anstatt darauf zu warten, dass die Ressource eine Herausforderung 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 Authentifizierungsheraufforderungen verursacht werden.

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

Gilt für: