SocketsHttpHandler Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет обработчик сообщений по умолчанию, используемый HttpClient.
public ref class SocketsHttpHandler sealed : System::Net::Http::HttpMessageHandler[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public sealed class SocketsHttpHandler : System.Net.Http.HttpMessageHandlerpublic sealed class SocketsHttpHandler : System.Net.Http.HttpMessageHandler[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type SocketsHttpHandler = class
inherit HttpMessageHandlertype SocketsHttpHandler = class
inherit HttpMessageHandlerPublic NotInheritable Class SocketsHttpHandler
Inherits HttpMessageHandler- Наследование
- Атрибуты
Комментарии
Класс SocketsHttpHandler предоставляет реализацию, используемую более высоким уровнем сетевых классов HTTP, таких как HttpClient. Использование SocketsHttpHandler предлагает ряд преимуществ:
- Значительное улучшение производительности по сравнению с предыдущей реализацией.
- Устранение зависимостей платформы, упрощающее развертывание и обслуживание. Например,
libcurlбольше не зависит от .NET для macOS и Linux. - Согласованное поведение на всех платформах .NET.
Конструкторы
| Имя | Описание |
|---|---|
| SocketsHttpHandler() |
Создает экземпляр SocketsHttpHandler класса. |
Свойства
| Имя | Описание |
|---|---|
| ActivityHeadersPropagator |
Возвращает или задает распространитель, используемый при распространении распределенной трассировки и контекста.
Используется |
| AllowAutoRedirect |
Возвращает или задает значение, указывающее, должен ли обработчик следовать ответам перенаправления. |
| AutomaticDecompression |
Возвращает или задает тип метода декомпрессии, используемого обработчиком для автоматического распаковки ответа на содержимое HTTP. |
| ConnectCallback |
Возвращает или задает пользовательский обратный вызов, используемый для открытия новых подключений. |
| ConnectTimeout |
Возвращает или задает интервал времени ожидания, прежде чем соединение устанавливает время ожидания. |
| CookieContainer |
Возвращает или задает объект контейнера управляемого файла cookie. |
| Credentials |
Возвращает или задает сведения о проверке подлинности, используемые этим обработчиком. |
| DefaultProxyCredentials |
Если используется прокси-сервер по умолчанию (система), получает или задает учетные данные, используемые для отправки на прокси-сервер по умолчанию для проверки подлинности. |
| EnableMultipleHttp2Connections |
Возвращает или задает значение, указывающее, можно ли установить дополнительные подключения HTTP/2 к одному серверу. |
| EnableMultipleHttp3Connections |
Возвращает или задает значение, указывающее, можно ли установить дополнительные подключения HTTP/3 к одному серверу. |
| Expect100ContinueTimeout |
Возвращает или задает значение времени ожидания для ответа HTTP 100 "Продолжить". |
| InitialHttp2StreamWindowSize |
Определяет начальный размер окна получения потока HTTP2 для всех подключений, открытых этим SocketsHttpHandlerпараметром. |
| IsSupported |
Возвращает значение, указывающее, поддерживается ли обработчик на текущей платформе. |
| KeepAlivePingDelay |
Возвращает или задает задержку проверки связи в живых. |
| KeepAlivePingPolicy |
Возвращает или задает поведение проверки связи в живых. |
| KeepAlivePingTimeout |
Возвращает или задает время ожидания проверки связи. |
| MaxAutomaticRedirections |
Возвращает или задает максимально допустимое количество разрешенных перенаправлений HTTP. |
| MaxConnectionsPerServer |
Возвращает или задает максимальное число одновременных TCP-подключений, разрешенных одному серверу. |
| MaxResponseDrainSize |
Возвращает или задает максимальный объем данных, которые можно слить из ответов в байтах. |
| MaxResponseHeadersLength |
Возвращает или задает максимальную длину в килобайтах (1024 байта) заголовков ответа. |
| MeterFactory |
Возвращает или задает IMeterFactory для создания настраиваемого Meter экземпляра SocketsHttpHandler . |
| PlaintextStreamFilter |
Возвращает или задает пользовательский обратный вызов, предоставляющий доступ к потоку протокола HTTP обычного текста. |
| PooledConnectionIdleTimeout |
Возвращает или задает время простоя подключения в пуле, который будет считаться повторно используемым. |
| PooledConnectionLifetime |
Возвращает или задает время, когда подключение может находиться в пуле для повторного использования. |
| PreAuthenticate |
Возвращает или задает значение, указывающее, отправляет ли обработчик заголовок авторизации с запросом. |
| Properties |
Возвращает записываемый словарь (т. е. карту) настраиваемых свойств для запросов HttpClient. Словарь инициализирован пуст; вы можете вставлять и запрашивать пары "ключ-значение" для пользовательских обработчиков и специальной обработки. |
| Proxy |
Возвращает или задает пользовательский прокси-сервер при UseProxy использовании |
| RequestHeaderEncodingSelector |
Возвращает или задает обратный вызов, который выбирает Encoding значения заголовка запроса. |
| ResponseDrainTimeout |
Возвращает или задает интервал времени ожидания очистки данных из ответов. |
| ResponseHeaderEncodingSelector |
Возвращает или задает обратный вызов, который выбирает Encoding значения заголовка ответа декодировать. |
| SslOptions |
Возвращает или задает набор параметров, используемых для проверки подлинности TLS клиента. |
| UseCookies |
Возвращает или задает значение, указывающее, должен ли обработчик использовать файлы cookie. |
| UseProxy |
Возвращает или задает значение, указывающее, должен ли обработчик использовать прокси-сервер. |
Методы
| Имя | Описание |
|---|---|
| Dispose() |
Освобождает неуправляемые ресурсы и удаляет управляемые ресурсы, используемые параметром HttpMessageHandler. (Унаследовано от HttpMessageHandler) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые HttpMessageHandler и при необходимости удаляет управляемые ресурсы. (Унаследовано от HttpMessageHandler) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| Send(HttpRequestMessage, CancellationToken) |
При переопределении в производном классе отправляет HTTP-запрос с указанным маркером запроса и отмены. В противном случае вызывает NotSupportedExceptionисключение . (Унаследовано от HttpMessageHandler) |
| SendAsync(HttpRequestMessage, CancellationToken) |
Отправка HTTP-запроса в виде асинхронной операции. (Унаследовано от HttpMessageHandler) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
