ЗапросHttp

Настраиваемый и исполняемый HTTP-запрос к серверу.

При работе с URL-адресом существуют поддерживаемые и запрещенные символы. Все неподдерживаемые символы должны быть процент-кодированы. При этом, поддерживаемые символы (зарезервированные символы, разделители сегментов адреса, разделители внутри сегментов и т.д.) могут быть представлены как в натуральном, так и процент-кодированном виде. Во входящей строке ЗапросHttp сохраняются процент-кодированные представления символов, недопустимые символы будут заменены. Допустимыми являются все разделители внутри сегментов, которые указаны в стандарте RFC 3986: “!”, “&”, “’”, “+”, “*”, “$”, “(“, “)”, “,”, “;”, “=”. Также для сегментов запрос и фрагмент допустимы “/”, “?”. Символы, которые являются разделителями сегментов, не меняются “:”, “/”, “?”, “#”, “[”, “]”, “@”. Не меняются разрешенные к использованию во всех частях url-адреса символы: “-“, “.”, “_”, “~”. Если во входящей строке представлены символы национальных алфавитов, то они также кодируются. Если такие символы идут в доменной части строки, то происходит IDN кодирование. Если в других частях url - процентное-кодирование символов.

Сравнение ссылочное

Примеры

знч Аутентификация = новый АутентификацияHttp("пользователь", "пароль")
знч Запрос = КлиентHttp.ЗапросGet("http://адрес")
исп Ответ = Запрос.УстановитьАутентификацию(Аутентификация).Выполнить()

Свойства

АбсолютныйUrl

Декодированный URL-адрес, к которому будет выполняться запрос. Даже если в запросе был указан относительный путь, это свойство будет содержать абсолютный путь к запрошенному ресурсу.

Аутентификация

Данные аутентификации при выполнении этого запроса.

Заголовки

Заголовки запроса.

МаксимумПеренаправлений

Максимальное количество переходов.

МетодHttp

Возвращает HTTP-метод запроса.

Прокси

Настройки прокси-сервера, которые будут использованы при выполнении данного запроса.

ТаймаутЗапроса

Таймаут для запросов.

ТаймаутСоединения

Таймаут соединения с сервером.

Методы

Выполнить

Выполняет HTTP-запрос с контекстом Контекст и возвращает ответ.

ДобавитьЗаголовки

Добавляет все заголовки из заданной коллекции заголовков Заголовки. Возвращает текущий экземпляр.

ДобавитьЗаголовок

Добавляет новый заголовок Заголовок со значением Значение. Запрещено устанавливать заголовки “Content-Length” и “Transfer-Encoding”. Возвращает текущий экземпляр.

ОчиститьЗаголовки

Удаляет все заголовки. Возвращает текущий экземпляр.

УдалитьЗаголовок

Удаляет заголовок с именем Заголовок (если есть). Возвращает текущий экземпляр.

УстановитьCookies

Устанавливает значение Cookies заголовка “Cookies”. Возвращает текущий экземпляр.

УстановитьUserAgent

Устанавливает значение UserAgent заголовка “UserAgent”. Возвращает текущий экземпляр.

УстановитьАутентификацию

Устанавливает данные аутентификации при выполнении этого запроса. Возвращает текущий экземпляр.

УстановитьЗаголовки

Очищает заголовки и копирует все заголовки из заданной коллекции Заголовки. Запрещено устанавливать заголовки “Content-Length” и “Transfer-Encoding”. Возвращает текущий экземпляр.

УстановитьЗаголовок

Устанавливает значение Значение заголовка Заголовок. Запрещено устанавливать заголовки “Content-Length” и “Transfer-Encoding”. Возвращает текущий экземпляр.

УстановитьМаксимумПеренаправлений

Устанавливает максимальное количество перенаправлений Количество. Возвращает текущий экземпляр.

УстановитьПрокси

Устанавливает настройки прокси-сервера Прокси, которые будут использованы при выполнении данного запроса. Возвращает текущий экземпляр.

УстановитьТаймаутЗапроса

Устанавливает значение таймаута Таймаут выполнения этого запроса. Возвращает текущий экземпляр.

УстановитьТаймаутСоединения

Устанавливает время ожидания Таймаут установки соединения для этого запроса. Возвращает текущий экземпляр.

УстановитьТело

Устанавливает тело запроса из строки Тело. Возвращает текущий экземпляр.

УстановитьТело

Устанавливает тело запроса из файла Файл. Непосредственно чтение из файла выполняется в момент выполнения запроса. Возвращает текущий экземпляр.

УстановитьТело

Устанавливает тело запроса из потока Поток. Запрос будет выполнен с использованием механизма Chunked transfer encoding. Непосредственно чтение из потока выполняется в момент выполнения запроса. После выполнения запроса поток будет закрыт. Возвращает текущий экземпляр.

УстановитьТело

Устанавливает тело запроса из потока Поток указанного размера Размер. Непосредственно чтение из потока выполняется в момент выполнения запроса. После выполнения запроса поток будет закрыт. Возвращает текущий экземпляр.

УстановитьТипСодержимого

Устанавливает значение ТипСодержимого заголовка “Content-Type”. Возвращает текущий экземпляр.