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

Определение

Внимание!

The AuthenticationManager Authenticate and PreAuthenticate methods are not supported and throw PlatformNotSupportedException.

Выполняет предварительную проверку подлинности запроса.Preauthenticates a request.

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

Запрос WebRequest интернет-ресурса.A WebRequest to an Internet resource.

credentials
ICredentials

Учетная запись ICredentials, связанная с запросом.The ICredentials associated with the request.

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

Authorization

Если предварительная проверка подлинности запроса может быть выполнена, возвращается экземпляр класса Authorization; в противном случае возвращается null.An instance of the Authorization class if the request can be preauthenticated; otherwise, null. Если значением параметра credentials является null, метод возвращает null.If credentials is null, this method returns null.

Атрибуты

Исключения

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

Комментарии

Если модуль проверки подлинности может выполнить предварительную проверку подлинности запроса, PreAuthenticate метод возвращает экземпляр проверки подлинности и отправляет сведения об авторизации на сервер с вытеснением, а не ожидает, пока ресурс выдаст запрос.If the authentication module can preauthenticate the request, the PreAuthenticate method returns an Authentication instance and sends the authorization information to the server preemptively instead of waiting for the resource to issue a challenge. Это поведение описано в разделе 3,3 RFC 2617 (проверка подлинности HTTP: обычная и дайджест-проверка подлинности).This behavior is outlined in section 3.3 of RFC 2617 (HTTP Authentication: Basic and Digest Access Authentication). Модули проверки подлинности, поддерживающие предварительную проверку подлинности, позволяют клиентам повысить эффективность сервера, избегая лишних циклов обработки, вызванных проблемами аутентификацииAuthentication modules that support preauthentication allow clients to improve server efficiency by avoiding extra round trips caused by authentication challenges.

Модули авторизации, которые могут выполнять предварительную проверку подлинности запросов, устанавливают IAuthenticationModule.CanPreAuthenticate свойство в значение true .Authorization modules that can preauthenticate requests set the IAuthenticationModule.CanPreAuthenticate property to true.

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