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


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);
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.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свойства значение .

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