AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.Requests.dll

Sumber:

AuthenticationManager.cs

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);

[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);

[<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

Public Shared Function PreAuthenticate (request As WebRequest, credentials As ICredentials) As Authorization

Parameter

request

WebRequest

Permintaan ke sumber daya internet.

credentials

ICredentials

Kredensial yang terkait dengan permintaan.

Mengembalikan

Authorization

Instans Authorization kelas jika permintaan dapat diabaikan sebelumnya; jika tidak, null. Jika credentials adalah null, metode ini mengembalikan null.

Atribut

ObsoleteAttribute

Pengecualian

PlatformNotSupportedException

Hanya .NET Core dan .NET 5+: Dalam semua kasus.

ArgumentNullException

requestadalah null.

Keterangan

Jika modul autentikasi dapat melakukan praautentikasi permintaan, PreAuthenticate metode mengembalikan instans Autentikasi dan mengirim informasi otorisasi ke server terlebih dahulu alih-alih menunggu sumber daya mengeluarkan tantangan. Perilaku ini diuraikan dalam bagian 3.3 dari 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 praauthentikasi permintaan mengatur properti ke IAuthenticationModule.CanPreAuthenticatetrue.