AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Förautentiserar en begäran.
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 AuthorizationParametrar
- request
- WebRequest
En begäran till en Internetresurs.
- credentials
- ICredentials
De autentiseringsuppgifter som är associerade med begäran.
Returer
En instans av Authorization klassen om begäran kan förautentiseras, nullannars . Om credentials är nullreturnerar nullden här metoden .
Undantag
.NET Core och .NET endast 5+ : I samtliga fall.
request är null.
Kommentarer
Om autentiseringsmodulen kan förautentisera begäran PreAuthenticate returnerar metoden en autentiseringsinstans och skickar auktoriseringsinformationen till servern förebyggande i stället för att vänta på att resursen ska utfärda en utmaning. Det här beteendet beskrivs i avsnitt 3.3 i RFC 2617 (HTTP-autentisering: Grundläggande och sammanfattad åtkomstautentisering). Autentiseringsmoduler som stöder förautentisering gör det möjligt för klienter att förbättra serverns effektivitet genom att undvika extra turer som orsakas av autentiseringsutmaningar.
Auktoriseringsmoduler som kan förautentisera begäranden anger IAuthenticationModule.CanPreAuthenticate egenskapen till true.