AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Perhatian
The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.
Melakukan pra-oentensi permintaan.
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
Permintaan ke sumber daya internet.
- credentials
- ICredentials
Kredensial yang terkait dengan permintaan.
Mengembalikan
Instans Authorization kelas jika permintaan dapat diresahkan sebelumnya; jika tidak, null. Jika credentials adalah null, metode ini mengembalikan null.
- Atribut
Pengecualian
.NET Core dan .NET 5+ saja: Dalam semua kasus.
request adalah null.
Keterangan
Jika modul autentikasi dapat melakukan praautentikasi permintaan, PreAuthenticate metode mengembalikan instans Autentikasi dan mengirim informasi otorisasi ke server secara preemtif alih-alih menunggu sumber daya mengeluarkan tantangan. Perilaku ini diuraikan dalam bagian 3.3 RFC 2617 (Autentikasi HTTP: Autentikasi Akses Dasar dan Hash). Modul autentikasi yang mendukung praautentikasi memungkinkan klien untuk meningkatkan efisiensi server dengan menghindari perjalanan pulang pergi tambahan yang disebabkan oleh tantangan autentikasi.
Modul otorisasi yang dapat melakukan praautomatis permintaan mengatur IAuthenticationModule.CanPreAuthenticate properti ke true.
