AuthenticationManager.Authenticate(String, WebRequest, ICredentials) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Внимание!
The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.
Вызывает все зарегистрированные модули проверки подлинности, чтобы найти модуль, который может ответить на запрос проверки подлинности.
public:
static System::Net::Authorization ^ Authenticate(System::String ^ challenge, 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? Authenticate (string challenge, System.Net.WebRequest request, System.Net.ICredentials credentials);
public static System.Net.Authorization? Authenticate (string challenge, System.Net.WebRequest request, System.Net.ICredentials credentials);
public static System.Net.Authorization Authenticate (string challenge, 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 Authenticate : string * System.Net.WebRequest * System.Net.ICredentials -> System.Net.Authorization
static member Authenticate : string * System.Net.WebRequest * System.Net.ICredentials -> System.Net.Authorization
Public Shared Function Authenticate (challenge As String, request As WebRequest, credentials As ICredentials) As Authorization
Параметры
- challenge
- String
Запрос, возвращаемый интернет-ресурсом.
- request
- WebRequest
Запрос, который инициировал запрос проверки подлинности.
- credentials
- ICredentials
Учетные данные, связанные с этим запросом.
Возвращаемое значение
Экземпляр класса Authorization, содержащий результат попытки авторизации. Если на запрос не отвечает ни один из модулей проверки подлинности, этот метод возвращает null
.
- Атрибуты
Исключения
Только .NET Core и .NET 5+: Во всех случаях.
challenge
имеет значение null
.
-или-
request
имеет значение null
.
-или-
credentials
имеет значение null
.
Комментарии
Метод Authenticate вызывает метод для IAuthenticationModule.Authenticate каждого зарегистрированного модуля проверки подлинности, пока один из модулей не ответит экземпляром Authorization .
Первый Authorization возвращенный экземпляр используется для проверки подлинности запроса. Если ни в каких модулях проверки подлинности не удается проверить подлинность запроса, Authenticate метод возвращает .null
Модули проверки подлинности вызываются в порядке их регистрации в AuthenticationManager.