AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.Requests.dll

Kaynak:

AuthenticationManager.cs

Dikkat

The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.

bir isteği önceden doğrular.

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

Parametreler

request

WebRequest

İnternet kaynağına yönelik bir istek.

credentials

ICredentials

İstekle ilişkili kimlik bilgileri.

Döndürülenler

Authorization

İstek önceden kimlik doğrulamasından geçmişse sınıfının bir örneği Authorization ; aksi takdirde , null. ise credentialsnull, bu yöntem döndürür null.

Öznitelikler

ObsoleteAttribute

Özel durumlar

PlatformNotSupportedException

Yalnızca .NET Core ve .NET 5+ : Her durumda.

ArgumentNullException

request, null değeridir.

Açıklamalar

Kimlik doğrulama modülü isteğin ön kimliğini doğrulayabilirse, PreAuthenticate yöntemi bir Kimlik Doğrulama örneği döndürür ve kaynağın bir sınama başlatmasını beklemek yerine yetkilendirme bilgilerini önceden sunucuya gönderir. Bu davranış RFC 2617'nin (HTTP Kimlik Doğrulaması: Temel ve Özet Erişim Kimlik Doğrulaması) 3.3. bölümünde özetlenmiştir. Ön kimlik doğrulamayı destekleyen kimlik doğrulama modülleri, istemcilerin kimlik doğrulama güçlüklerinden kaynaklanan ek gidiş dönüşleri önleyerek sunucu verimliliğini artırmasına olanak tanır.

İstekleri önceden doğrulayan yetkilendirme modülleri özelliğini olarak trueayarlarIAuthenticationModule.CanPreAuthenticate.