Поддержка HTTP в .NET

Протокол гипертекстовой передачи (или HTTP) — это протокол для запроса ресурсов с веб-сервера. Класс System.Net.Http.HttpClient предоставляет возможность отправлять HTTP-запросы и получать HTTP-ответы от ресурса, определяемого URI. Многие типы ресурсов доступны в Интернете, и HTTP определяет набор методов запроса для доступа к этим ресурсам.

Методы HTTP-запроса

Методы запроса различаются по нескольким факторам, сначала по их глаголу, а также по следующим характеристикам:

• Метод запроса является идемпотентным, если он может быть успешно обработан несколько раз без изменения результата. Дополнительные сведения см. в статье RFC 9110: 9.2.2. Идемпотентные методы.
• Метод запроса кэшируемый, если соответствующий ответ может храниться для повторного использования. Дополнительные сведения см. в разделе RFC 9110: раздел 9.2.3. Методы и кэширование.
• Метод запроса считается безопасным методом, если он не изменяет состояние ресурса. Все безопасные методы также идемпотентными, но не все идемпотентные методы считаются безопасными. Дополнительные сведения см. в разделе RFC 9110: раздел 9.2.1. Безопасные методы.

^†Метод POST кэшируется только при наличии соответствующих заголовков ответа Cache-Control или Expires. Это очень редко на практике.

Коды состояния HTTP

.NET предоставляет полную поддержку протокола HTTP, который составляет основную часть интернет-трафика вместе с HttpClient. Дополнительные сведения см. в статье Создание HTTP-запросов с помощью класса HttpClient. Приложения получают ошибки протокола HTTP, перехватив HttpRequestException. Коды состояния HTTP либо сообщаются в HttpResponseMessage с HttpResponseMessage.StatusCode, либо в HttpRequestException с HttpRequestException.StatusCode в случае, если вызываемый метод не возвращает ответное сообщение. Для получения дополнительной информации об обработке ошибок см. обработка ошибок HTTP, а чтобы узнать больше о кодах состояния, см. RFC 9110, Семантика HTTP: Коды состояния.

Информационные коды состояния

Коды информационных состояний отражают промежуточный ответ. Большинство промежуточных ответов, например HttpStatusCode.Continue, обрабатываются внутри HttpClient и никогда не отображаются пользователю.

Успешные коды состояния

Коды успешного состояния указывают, что запрос клиента был успешно получен, понят и принят.

Коды состояния перенаправления

Коды состояния перенаправления требуют от агента пользователя принять меры для выполнения запроса. Автоматическое перенаправление включается по умолчанию, его можно изменить с помощью HttpClientHandler.AllowAutoRedirect или SocketsHttpHandler.AllowAutoRedirect.

Коды состояния ошибок клиента

Коды состояния ошибки клиента указывают, что запрос клиента недопустим.

Коды состояния ошибки сервера

Коды состояния ошибки сервера указывают на то, что сервер столкнулся с непредвиденным состоянием, которое не позволило выполнить запрос.

См. также

• сделать HTTP-запросы с помощью класса HttpClient
• фабрика клиентов HTTP в .NET
• рекомендации по использованию httpClient
• улучшения сетевых функций .NET