Поделиться через


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

Определение

Внимание!

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);
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}")>]
static member PreAuthenticate : System.Net.WebRequest * System.Net.ICredentials -> System.Net.Authorization
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; в противном случае возвращается null. Если значением параметра credentials является null, метод возвращает null.

Атрибуты

Исключения

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

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

Комментарии

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

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

Применяется к