HttpClient.Send Метод

Определение

Пространство имен:

System.Net.Http

Сборки:

netstandard.dll, System.Net.Http.dll

Перегрузки

Имя	Описание
Send(HttpRequestMessage)	Отправляет HTTP-запрос с указанным запросом.
Send(HttpRequestMessage, HttpCompletionOption)	Отправляет HTTP-запрос.
Send(HttpRequestMessage, CancellationToken)	Отправляет HTTP-запрос с указанным маркером запроса и отмены.
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Отправляет HTTP-запрос с указанным запросом, параметром завершения и маркером отмены.

Send(HttpRequestMessage)

Исходный код:

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);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage -> System.Net.Http.HttpResponseMessage

Public Function Send (request As HttpRequestMessage) As HttpResponseMessage

Параметры

request

HttpRequestMessage

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

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

HttpResponseMessage

Http-ответное сообщение.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

ArgumentNullException

Значение request равно null.

NotSupportedException

Http-версия — 2.0 или более поздняя, или политика версий имеет значение RequestVersionOrHigher.

–или–

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

–или–

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

InvalidOperationException

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

HttpRequestException

Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError.

OperationCanceledException

OperationCanceledException Если исключение вложено TimeoutExceptionв : запрос завершился сбоем из-за времени ожидания.

Send(HttpRequestMessage, HttpCompletionOption)

Исходный код:

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);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Net.Http.HttpResponseMessage

Public Function Send (request As HttpRequestMessage, completionOption As HttpCompletionOption) As HttpResponseMessage

Параметры

request

HttpRequestMessage

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

completionOption

HttpCompletionOption

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

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

HttpResponseMessage

Http-ответное сообщение.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

ArgumentNullException

Значение request равно null.

NotSupportedException

Http-версия — 2.0 или более поздняя, или политика версий имеет значение RequestVersionOrHigher.

–или–

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

–или–

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

InvalidOperationException

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

HttpRequestException

Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError.

OperationCanceledException

OperationCanceledException Если исключение вложено TimeoutExceptionв : запрос завершился сбоем из-за времени ожидания.

Send(HttpRequestMessage, CancellationToken)

Исходный код:

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);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Net.Http.HttpResponseMessage

Public Overrides Function Send (request As HttpRequestMessage, cancellationToken As CancellationToken) As HttpResponseMessage

Параметры

request

HttpRequestMessage

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

cancellationToken

CancellationToken

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

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

HttpResponseMessage

Http-ответное сообщение.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

ArgumentNullException

Значение request равно null.

NotSupportedException

Http-версия — 2.0 или более поздняя, или политика версий имеет значение RequestVersionOrHigher.

–или–

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

–или–

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

InvalidOperationException

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

HttpRequestException

Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError.

OperationCanceledException

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

–или–

.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.

Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Исходный код:

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);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Net.Http.HttpResponseMessage

Public Function Send (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As HttpResponseMessage

Параметры

request

HttpRequestMessage

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

completionOption

HttpCompletionOption

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

cancellationToken

CancellationToken

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

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

HttpResponseMessage

Http-ответное сообщение.

Атрибуты

UnsupportedOSPlatformAttribute

Исключения

ArgumentNullException

Значение request равно null.

NotSupportedException

Http-версия — 2.0 или более поздняя, или политика версий имеет значение RequestVersionOrHigher.

–или–

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

–или–

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

InvalidOperationException

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

HttpRequestException

Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError.

OperationCanceledException

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

–или–

.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.