AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Een aanvraag voorafauthenticeert.
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.AuthorizationPublic Shared Function PreAuthenticate (request As WebRequest, credentials As ICredentials) As AuthorizationParameters
- request
- WebRequest
Een aanvraag voor een internetresource.
- credentials
- ICredentials
De referenties die zijn gekoppeld aan de aanvraag.
Retouren
Een exemplaar van de Authorization klasse als de aanvraag vooraf kan worden geverifieerd; nullanders. Als credentials dat het is null, retourneert nulldeze methode .
Uitzonderingen
.NET Core en .NET 5+ alleen: in alle gevallen.
request is null.
Opmerkingen
Als de verificatiemodule de aanvraag vooraf kan verifiëren, retourneert de PreAuthenticate methode een verificatie-exemplaar en worden de autorisatiegegevens naar de server verzonden in plaats van te wachten tot de resource een uitdaging uitgeeft. Dit gedrag wordt beschreven in sectie 3.3 van RFC 2617 (HTTP-verificatie: basis- en digesttoegangsverificatie). Met verificatiemodules die ondersteuning bieden voor verificatie vooraf, kunnen clients de serverefficiëntie verbeteren door extra retouren te voorkomen die worden veroorzaakt door verificatieproblemen.
Autorisatiemodules die aanvragen vooraf kunnen verifiëren, stellen de IAuthenticationModule.CanPreAuthenticate eigenschap in op true.