AuthenticationManager.PreAuthenticate(WebRequest, ICredentials) Метод

Определение

Пространство имен:

System.Net

Сборка:

System.Net.Requests.dll

Исходный код:

AuthenticationManager.cs

Внимание!

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

Выполняет предварительную проверку подлинности запроса.

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

Параметры

request

WebRequest

Запрос к интернет-ресурсу.

credentials

ICredentials

Учетные данные, связанные с запросом.

Возвращаемое значение

Authorization

Если предварительная проверка подлинности запроса может быть выполнена, возвращается экземпляр класса Authorization; в противном случае возвращается null. Если значением параметра credentials является null, метод возвращает null.

Атрибуты

ObsoleteAttribute

Исключения

PlatformNotSupportedException

Только .NET Core и .NET 5+: Во всех случаях.

ArgumentNullException

request имеет значение null.

Комментарии

Если модуль проверки подлинности может предварительно пройти проверку подлинности запроса, PreAuthenticate метод возвращает экземпляр проверки подлинности и отправляет сведения об авторизации на сервер заранее, а не дожидаясь, пока ресурс выдаст запрос. Это поведение описано в разделе 3.3 документа RFC 2617 (Проверка подлинности HTTP: обычная и дайджест-проверка подлинности). Модули проверки подлинности, поддерживающие предварительную проверку подлинности, позволяют клиентам повысить эффективность сервера, избегая дополнительных циклов, вызванных проблемами проверки подлинности.

Модули авторизации, которые могут предварительно пройти проверку подлинности запросов, IAuthenticationModule.CanPreAuthenticate устанавливают для свойства значение true.