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

Ссылка

Определение

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

Сборка:: System.Net.Requests.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Внимание!

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);

[<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

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

Атрибуты: ObsoleteAttribute

Исключения

PlatformNotSupportedException

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

ArgumentNullException

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

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

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

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