HttpRequest

public bool AcceptGZip { get; set; }

Запрашивает gzip/deflate, если Accept-Encoding не указан, и включает обработку соответствующего Content-Encoding ответа. Лимит распакованных данных остаётся необходимым.

public bool AppendToDownloadFile { get; set; }

Разрешает продолжение записи при подходящем ответе Partial Content. Не заменяет проверку Range/Content-Range и идентичности уже скачанного файла.

public int BodySizeLimit { get; set; }

Лимит тела в байтах; -1 отключает лимит. При автоматической распаковке ограничивается также итоговое распакованное тело. Для внешних ответов задавайте явный бюджет.

public int DownloadChunkSize { get; set; }

Размер используемого буфера и максимальное количество байтов для чтения за одну итерацию. См. HttpClient.ReadChunkSize. Установите меньшее значение (например, 4096 для 4 КиБ) при загрузке небольших файлов, чтобы уменьшить использование памяти за счет скорости загрузки.

public string DownloadFile { get; set; }

Путь записи тела ответа вместо хранения его в body сигнала. Успешная запись не подтверждает HTTP 2xx или пригодность содержимого; сначала используйте временный файл.

public bool KeepPartialDownload { get; set; }

Сохраняет незавершённый файл при остановке запроса. Частичный файл не считается готовым ресурсом; проверяйте длину/содержимое перед использованием.

public int MaxRedirects { get; set; }

Предел автоматических перенаправлений; 0 запрещает их, -1 отключает предел. Проверяйте адрес, метод и заголовки при переходах.

public double Timeout { get; set; }

Срок ожидания в секундах; 0 отключает тайм-аут. Встроенный Timer игнорирует TimeScale, однако его обработка зависит от EntityTree/паузы.

public bool UseThreads { get; set; }

Включает внутренний рабочий поток, если сборка его поддерживает. Не делает ваши обработчики или доступ к EntityTree автоматически потокобезопасными.

public void CancelRequest();

Останавливает текущий запрос; сам по себе не выдаёт RequestCompleted для отмены. При файловой загрузке очистка зависит от завершённости и KeepPartialDownload.

public int GetBodySize();

Возвращает длину тела запроса. Примечание: Некоторые веб-серверы могут не отправлять длину тела. В этом случае возвращаемое значение будет -1. При использовании кодирования передачи по частям длина тела также будет -1.

public int GetDownloadedBytes();

Возвращает количество байтов HTTPRequest скачаны.

public HttpClient.Status GetHttpClientStatus();

Возвращает текущий статус базового HttpClient.

public Error Request(string url, ReadOnlySpan<string> customHeaders, HttpClient.Method method, string requestData);

Запускает HTTP-запрос; строковое тело кодируется в UTF-8. Требует дерево и свободный экземпляр. Error.Ok не означает полученный HTTP 2xx: результат проверяется в RequestCompleted.

public Error Request(string url, string[] customHeaders = null, HttpClient.Method method = HttpClient.Method.Get, string requestData = "");

Запускает HTTP-запрос; строковое тело кодируется в UTF-8. Требует дерево и свободный экземпляр. Error.Ok не означает полученный HTTP 2xx: результат проверяется в RequestCompleted.

public Error RequestRaw(string url, ReadOnlySpan<string> customHeaders, HttpClient.Method method, ReadOnlySpan<byte> requestDataRaw);

Отправляет точные байты тела. Метод и Content-Type должны соответствовать API. При неоднозначности перегрузок задайте типы массивов явно.

public Error RequestRaw(string url, string[] customHeaders = null, HttpClient.Method method = HttpClient.Method.Get, byte[] requestDataRaw = null);

Отправляет точные байты тела. Метод и Content-Type должны соответствовать API. При неоднозначности перегрузок задайте типы массивов явно.

public void SetHttpProxy(string host, int port);

Устанавливает прокси-сервер для HTTP-запросов. Прокси-сервер не установлен, если host пуст или port равен -1.

public void SetHttpsProxy(string host, int port);

Устанавливает прокси-сервер для HTTPS-запросов. Прокси-сервер не установлен, если host пуст или port равен -1.

public void SetTlsOptions(TlsOptions clientOptions);

Задаёт клиентские параметры для HTTPS. Используйте проверяющий Client; корректно загрузите собственный CA до запуска запроса.

public event HttpRequest.RequestCompletedEventHandler RequestCompleted;

Сообщает результат передачи, HTTP-код, заголовки и байты тела. Result.Success возможен вместе с 404. При DownloadFile тело сохраняется в файл, а body остаётся пустым.