WinHttpHandler Class

Definition

WinHttpHandler является специальным обработчиком сообщений на основе интерфейса WinHTTP в Windows и предназначен для работы в серверных средах.WinHttpHandler is a specialty message handler based on the WinHTTP interface of Windows and is intended for use in server environments. Этот класс также можно использовать в классических приложениях, установив его в виде пакета NuGet.This class is also available for use in Desktop apps by installing it as a NuGet package. Дополнительные сведения об установке этого класса для использования в классических приложениях см. в разделе System.Net.Http.WinHttpHandler.For more information about installing this class for use in Desktop apps, see System.Net.Http.WinHttpHandler.

public ref class WinHttpHandler : System::Net::Http::HttpMessageHandler
public class WinHttpHandler : System.Net.Http.HttpMessageHandler
type WinHttpHandler = class
    inherit HttpMessageHandler
Public Class WinHttpHandler
Inherits HttpMessageHandler
Inheritance
WinHttpHandler

Remarks

WinHttpHandler аналогична другим существующим классам, например HttpClientHandler.WinHttpHandler is similar to other existing classes such as HttpClientHandler. WinHttpHandler предоставляет обработчик под экземпляром HttpClient и используется для отправки HTTP-запросов серверу и получения ответов сервера.WinHttpHandler provides a handler underneath an HttpClient instance and is used to send HTTP requests out to a server and receive server responses.

WinHttpHandler предназначен для использования в основном в серверных средах ASP.NET Core и других приложений .NET, взаимодействующих с HTTP-серверами.WinHttpHandler is designed to be used primarily in server environments by ASP.NET Core and other .NET applications that communicate with HTTP servers. WinHttpHandler также предоставляет разработчикам более детализированный контроль над обменом данными по протоколу HTTP приложения, чем класс HttpClientHandler.WinHttpHandler also provides developers with more granular control over the application's HTTP communication than the HttpClientHandler class. Это позволяет разработчикам реализовывать более сложные сценарии HTTP или изменять системные значения по умолчанию (например, параметры прокси-сервера, время ожидания и проверка SSL-сертификата сервера).This allows developers to implement more advanced HTTP scenarios or modify system defaults (for example, proxy settings, timeouts and server SSL certificate validation).

WinHttpHandler не предназначены для замены HttpClientHandler, это более сложная версия, предоставляемая для тех сценариев, где HttpClientHandler недостаточна для разработчиков.WinHttpHandler is not intended to be a replacement for HttpClientHandler, it is a more advanced version provided for scenarios where HttpClientHandler is insufficient for developers. WinHttpHandler реализована как тонкая оболочка в интерфейсе WinHTTP Windows и поддерживается только в системах Windows.WinHttpHandler is implemented as a thin wrapper on the WinHTTP interface of Windows and is only supported on Windows systems.

При использовании цепочки нескольких обработчиков WinHttpHandler должны находиться в нижней части цепочки.When using a chain of multiple handlers, WinHttpHandler should be at the bottom of the chain.

Constructors

WinHttpHandler()

Инициализация нового экземпляра класса WinHttpHandler.Initializes a new instance of the WinHttpHandler class.

Properties

AutomaticDecompression

Получает или задает тип метода распаковки, используемого обработчиком для автоматической распаковки содержимого HTTP-ответа.Gets or sets the type of decompression method used by the handler for automatic decompression of the HTTP content response.

AutomaticRedirection

Возвращает или задает значение, которое указывает, должен ли обработчик следовать HTTP-ответам перенаправления.Gets or sets a value that indicates whether the handler should follow HTTP redirection responses.

CheckCertificateRevocationList

Возвращает или задает значение, указывающее, следует ли проверять список отзыва сертификатов во время процесса проверки сертификата SSL.Gets or sets a value that indicates whether to check the revocation list of certificates during SSL certificate validation.

ClientCertificateOption

Возвращает или задает значение, указывающее, выбирается ли автоматически сертификат из хранилища сертификатов, или может ли вызывающий объект передавать определенный клиентский сертификат.Gets or sets a value that indicates if the certificate is automatically picked from the certificate store or if the caller is allowed to pass in a specific client certificate.

ClientCertificates

Возвращает или задает коллекцию SSL-сертификатов проверки подлинности клиента, используемых обработчиком для проверки подлинности клиента, если свойству ClientCertificateOption задано значение Manual.Gets or sets a collection of client authentication SSL certificates that are used for client authentication by the Handler if the ClientCertificateOption property is set to Manual.

CookieContainer

Возвращает или задает управляемый объект контейнера файлов cookie.Gets or sets the managed cookie container object. Это свойство используется, только если свойству CookieUsePolicy задано значение UseSpecifiedCookieContainer.This property is only used when the CookieUsePolicy property is set to UseSpecifiedCookieContainer. В противном случае метод SendAsync(HttpRequestMessage, CancellationToken) вызывает исключение.Otherwise, the SendAsync(HttpRequestMessage, CancellationToken) method will throw an exception.

CookieUsePolicy

Возвращает или задает значение, указывающее способ использования файлов cookie и управления ими.Gets or sets a value that indicates how cookies should be managed and used. Разработчики могут игнорировать файлы cookie, разрешить обработчику управлять ими автоматически либо обрабатывать их вручную с помощью объекта CookieContainer.Developers can choose to ignore cookies, allow the handler to automatically manage them or manually handle them using a CookieContainer object.

DefaultProxyCredentials

Возвращает или задает учетные данные, используемые для проверки подлинности прокси-сервера.Gets or sets the credentials used to authenticate the user to an authenticating proxy.

MaxAutomaticRedirections

Возвращает или задает максимальное количество разрешенных перенаправлений HTTP.Gets or sets the maximum number of allowed HTTP redirects.

MaxConnectionsPerServer

Возвращает или задает максимальное разрешенное число одновременных подключений TCP к одному серверу.Gets or sets the maximum number of TCP connections allowed to a single server.

MaxResponseDrainSize

Возвращает или задает максимальный объем данных, который может быть извлечен из ответов в байтах.Gets or sets the maximum amount of data that can be drained from responses in bytes.

MaxResponseHeadersLength

Возвращает или задает максимальный размер заголовка из ответа сервера в байтах.Gets or sets the maximum size of the header portion from the server response in bytes.

PreAuthenticate

Возвращает или задает значение, которое указывает, отправляет ли обработчик заголовок Authorization вместе с запросом.Gets or sets a value that indicates whether the handler sends an Authorization header with the request.

Properties
Proxy

Возвращает или задает настраиваемый прокси-сервер в случае, когда свойство WindowsProxyUsePolicy задано для использования настаиваемого прокси-сервера.Gets or sets the custom proxy when the WindowsProxyUsePolicy property is set to use a custom proxy.

ReceiveDataTimeout

Возвращает или задает время ожидания для получения данных ответа от сервера.Gets or sets the timeout for receiving the data portion of a response from the server.

ReceiveHeadersTimeout

Возвращает или задает время ожидания для получения заголовков ответа от сервера.Gets or sets the timeout for receiving the headers of a response from the server.

SendTimeout

Возвращает или задает время ожидания для отправки запроса.Gets or sets the timeout for sending a request.

ServerCertificateValidationCallback

Возвращает или задает метод обратного вызова для проверки сертификата сервера.Gets or sets a callback method to validate the server certificate. Этот обратный вызов является частью подтверждения SSL.This callback is part of the SSL handshake.

ServerCredentials

Возвращает или задает учетные данные, которые следует использовать для проверки подлинности клиента на сервере.Gets or sets the credentials to be used by the client to authenticate to the server.

SslProtocols

Получает или задает коллекцию протоколов TLS/SSL, поддерживаемых клиентом.Gets or sets the collection of TLS/SSL protocols supported by the client.

WindowsProxyUsePolicy

Возвращает или задает параметр прокси-сервера.Gets or sets the proxy setting. Это свойство можно задать для отключения прокси-сервера, использования настраиваемого прокси-сервера или использования параметров прокси-сервера WinHTTP или WinInet на компьютере.This property can be set to disable the proxy, use a custom proxy, or use the proxy settings of WinHTTP or WinInet on the machine.

Methods

Dispose()

Освобождает неуправляемые ресурсы и удаляет управляемые ресурсы, используемые объектом HttpMessageHandler.Releases the unmanaged resources and disposes of the managed resources used by the HttpMessageHandler.

(Inherited from HttpMessageHandler)
Dispose(Boolean)
Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
SendAsync(HttpRequestMessage, CancellationToken)

Отправляет HTTP-запрос в качестве асинхронной операции.Sends an HTTP request as an asynchronous operation.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Applies to