Прочитать на английском

Поделиться через


HttpClient.Send Метод

Определение

Перегрузки

Send(HttpRequestMessage)

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

Send(HttpRequestMessage, HttpCompletionOption)

Отправляет HTTP-запрос.

Send(HttpRequestMessage, CancellationToken)

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

Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)

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

Send(HttpRequestMessage)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

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

public System.Net.Http.HttpResponseMessage Send (System.Net.Http.HttpRequestMessage request);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Net.Http.HttpResponseMessage Send (System.Net.Http.HttpRequestMessage request);

Параметры

request
HttpRequestMessage

Сообщение HTTP-запроса для отправки.

Возвращаемое значение

Ответное сообщение HTTP.

Атрибуты

Исключения

Значение параметра requestnull.

HTTP версии 2.0 или более поздней либо для политики выбора версий задано RequestVersionOrHigher.

-или-

Пользовательский класс, производный от HttpContent, не переопределяет метод SerializeToStream(Stream, TransportContext, CancellationToken).

-или-

Пользовательский класс HttpMessageHandler не переопределяет метод Send(HttpRequestMessage, CancellationToken).

Экземпляр HttpClient уже отправил сообщение с запросом.

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

Если исключение TaskCanceledException включает TimeoutException: не удалось выполнить запрос из-за истечения времени ожидания.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET 5, 6, 7, 8, 9

Send(HttpRequestMessage, HttpCompletionOption)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

Отправляет HTTP-запрос.

public System.Net.Http.HttpResponseMessage Send (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Net.Http.HttpResponseMessage Send (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);

Параметры

request
HttpRequestMessage

Сообщение HTTP-запроса для отправки.

completionOption
HttpCompletionOption

Одно из значений перечисления, указывающее, когда должна завершиться операция (как только будет доступен ответ или после чтения содержимого ответа).

Возвращаемое значение

Сообщение HTTP-ответа.

Атрибуты

Исключения

Значение параметра requestnull.

HTTP версии 2.0 или более поздней либо для политики выбора версий задано RequestVersionOrHigher.

-или-

Пользовательский класс, производный от HttpContent, не переопределяет метод SerializeToStream(Stream, TransportContext, CancellationToken).

-или-

Пользовательский класс HttpMessageHandler не переопределяет метод Send(HttpRequestMessage, CancellationToken).

Экземпляр HttpClient уже отправил сообщение с запросом.

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

Если исключение TaskCanceledException включает TimeoutException: не удалось выполнить запрос из-за истечения времени ожидания.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET 5, 6, 7, 8, 9

Send(HttpRequestMessage, CancellationToken)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

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

public override System.Net.Http.HttpResponseMessage Send (System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public override System.Net.Http.HttpResponseMessage Send (System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);

Параметры

request
HttpRequestMessage

Сообщение HTTP-запроса для отправки.

cancellationToken
CancellationToken

Маркер для отмены операции.

Возвращаемое значение

Сообщение HTTP-ответа.

Атрибуты

Исключения

Значение параметра requestnull.

HTTP версии 2.0 или более поздней либо для политики выбора версий задано RequestVersionOrHigher.

-или-

Пользовательский класс, производный от HttpContent, не переопределяет метод SerializeToStream(Stream, TransportContext, CancellationToken).

-или-

Пользовательский класс HttpMessageHandler не переопределяет метод Send(HttpRequestMessage, CancellationToken).

Экземпляр HttpClient уже отправил сообщение с запросом.

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

Запрос отменен.

-или-

Если исключение TaskCanceledException включает TimeoutException: не удалось выполнить запрос из-за истечения времени ожидания.

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET 5, 6, 7, 8, 9

Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

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

public System.Net.Http.HttpResponseMessage Send (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Net.Http.HttpResponseMessage Send (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

Параметры

request
HttpRequestMessage

Сообщение HTTP-запроса для отправки.

completionOption
HttpCompletionOption

Одно из значений перечисления, указывающее, когда должна завершиться операция (как только будет доступен ответ или после чтения содержимого ответа).

cancellationToken
CancellationToken

Маркер для отмены операции.

Возвращаемое значение

Сообщение HTTP-ответа.

Атрибуты

Исключения

Значение параметра requestnull.

HTTP версии 2.0 или более поздней либо для политики выбора версий задано RequestVersionOrHigher.

-или-

Пользовательский класс, производный от HttpContent, не переопределяет метод SerializeToStream(Stream, TransportContext, CancellationToken).

-или-

Пользовательский класс HttpMessageHandler не переопределяет метод Send(HttpRequestMessage, CancellationToken).

Экземпляр HttpClient уже отправил сообщение с запросом.

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

Запрос отменен.

-или-

Если исключение TaskCanceledException включает TimeoutException: не удалось выполнить запрос из-за истечения времени ожидания.

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET 5, 6, 7, 8, 9