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

Определение

Пространство имен:
System.Net
Сборка:
System.dll
Сборка:
netstandard.dll

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

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
Public Shared Function PreAuthenticate (request As WebRequest, credentials As ICredentials) As Authorization

Параметры

request
WebRequest

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

credentials
ICredentials

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

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

Authorization

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

Исключения

PlatformNotSupportedException

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

ArgumentNullException

request равно null.

Комментарии

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

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

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