System.Net.Http Пространство имен
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет интерфейс программирования для современных приложений HTTP.
Классы
| Имя | Описание |
|---|---|
| ByteArrayContent |
Предоставляет содержимое HTTP на основе массива байтов. |
| DelegatingHandler |
Тип обработчиков HTTP, которые делегировать обработку сообщений HTTP-ответов другому обработчику, называемому внутренним обработчиком. |
| FormUrlEncodedContent |
Контейнер для кортежей name/value, закодированных с помощью типа MIME application/x-www-form-urlencoded MIME. |
| HttpClient |
Предоставляет класс для отправки HTTP-запросов и получения HTTP-ответов из ресурса, определяемого URI. |
| HttpClientHandler |
Обработчик сообщений по умолчанию, используемый HttpClient в .NET Framework. |
| HttpContent |
Базовый класс, представляющий текст сущности HTTP и заголовки содержимого. |
| HttpMessageHandler |
Базовый тип обработчиков сообщений HTTP. |
| HttpMessageInvoker |
Специальный класс, позволяющий приложениям вызывать SendAsync(HttpRequestMessage, CancellationToken) метод в цепочке обработчиков HTTP. |
| HttpMethod |
Вспомогательный класс для получения и сравнения стандартных методов HTTP и создания новых методов HTTP. |
| HttpRequestException |
Базовый класс для исключений, создаваемых и HttpClient классамиHttpMessageHandler. |
| HttpRequestMessage |
Представляет сообщение HTTP-запроса. |
| HttpResponseMessage |
Представляет сообщение HTTP-ответа, включая код состояния и данные. |
| MessageProcessingHandler |
Базовый тип для обработчиков, которые выполняют только небольшую обработку запросов и /или ответных сообщений. |
| MultipartContent |
Предоставляет коллекцию объектов, сериализованных с помощью спецификации HttpContent типа контента multipart/* . |
| MultipartFormDataContent |
Предоставляет контейнер для содержимого, закодированного с помощью типа MIME с несколькими частями и формами. |
| ReadOnlyMemoryContent |
Предоставляет содержимое HTTP на ReadOnlyMemory<T>основе . |
| RtcRequestFactory |
Предоставляет интерфейс программирования для современных приложений HTTP. |
| StreamContent |
Предоставляет содержимое HTTP на основе потока. |
| StringContent |
Предоставляет содержимое HTTP на основе строки. |
| WebRequestHandler |
Предоставляет функции для настольных компьютеров, недоступные для приложений Магазина Windows или других сред. |
Перечисления
| Имя | Описание |
|---|---|
| ClientCertificateOption |
Указывает, как предоставляются сертификаты клиента. |
| HttpCompletionOption |
Указывает, следует ли считать HttpClient операции завершенными как только ответ будет доступен, либо после чтения всего сообщения ответа, включая содержимое. |
Комментарии
Пространство System.Net.Http имен предназначено для предоставления следующих компонентов:
- Компоненты клиента HTTP, позволяющие пользователям использовать современные веб-службы по протоколу HTTP.
- Компоненты HTTP, которые можно использовать как клиентами, так и серверами (например, заголовки и сообщения HTTP). Это обеспечивает согласованную модель программирования на стороне клиента и сервера для современных веб-служб по протоколу HTTP.
Пространство System.Net.Http имен и связанное System.Net.Http.Headers пространство имен предоставляют следующий набор компонентов:
- HttpClient — Основной класс, используемый для отправки и получения запросов по протоколу HTTP.
- HttpRequestMessage и HttpResponseMessage — HTTP-сообщения, определенные в RFC 2616 IETF.
- HttpHeaders — заголовки HTTP, определенные в RFC 2616 IETF.
- HttpClientHandler — обработчики HTTP, ответственные за создание сообщений HTTP-ответов.
Существуют различные обработчики сообщений HTTP, которые можно использовать:
- DelegatingHandler — Класс, используемый для подключения обработчика к цепочке обработчика.
- HttpMessageHandler — Простой класс, производный от этого, поддерживает наиболее распространенные требования для большинства приложений.
- HttpClientHandler — Класс, работающий в нижней части цепочки обработчиков, который фактически обрабатывает операции транспорта HTTP.
Содержимое HTTP-сообщения соответствует тексту сущности, определенному в RFC 2616.
Для содержимого HTTP можно использовать следующие классы:
- ByteArrayContent — содержимое HTTP на основе массива байтов.
- FormUrlEncodedContent — HTTP-содержимое кортежей name/value, закодированных с помощью типа MIME application/x-www-form-urlencoded.
- MultipartContent — HTTP-содержимое, сериализованное с помощью спецификации типа контента multipart/*.
- MultipartFormDataContent — содержимое HTTP, закодированное с помощью типа MIME с несколькими частями или формами.
- StreamContent — содержимое HTTP на основе потока.
- StringContent — содержимое HTTP на основе строки.
Если приложение использует System.Net.Http пространства имен и System.Net.Http.Headers собирается скачать большие объемы данных (50 мегабайт или больше), то он должен передавать эти загрузки и не использовать буферизацию по умолчанию. Если вы используете буферизацию по умолчанию, использование памяти клиента будет очень большим, что может привести к значительно снижению производительности.