AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Methode
Definition
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.
Eine Anforderung wird vorab authentifiziert.
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}")]
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);static member PreAuthenticate : System.Net.WebRequest * System.Net.ICredentials -> System.Net.Authorization[<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.AuthorizationPublic Shared Function PreAuthenticate (request As WebRequest, credentials As ICredentials) As AuthorizationParameter
- request
- WebRequest
Eine Anforderung an eine Internetressource.
- credentials
- ICredentials
Die mit der Anforderung verknüpften Anmeldeinformationen.
Gibt zurück
Eine Instanz der Authorization Klasse, wenn die Anforderung vorab authentifiziert werden kann; andernfalls null. Ist credentials dies der Fall null, gibt diese Methode zurück null.
- Attribute
Ausnahmen
Nur .NET Core und .NET 5+ : 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 Abfrage 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 true.
