HttpClient.SendAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отправка HTTP-запроса в виде асинхронной операции.
Перегрузки
| Имя | Описание |
|---|---|
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Отправка HTTP-запроса в виде асинхронной операции. |
| SendAsync(HttpRequestMessage) |
Отправка HTTP-запроса в виде асинхронной операции. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
Отправка HTTP-запроса в виде асинхронной операции. |
| SendAsync(HttpRequestMessage, CancellationToken) |
Отправка HTTP-запроса в виде асинхронной операции. |
Комментарии
Эта операция не блокируется.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
Отправка HTTP-запроса в виде асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Параметры
- request
- HttpRequestMessage
Сообщение HTTP-запроса для отправки.
- completionOption
- HttpCompletionOption
Когда операция должна завершиться (как только ответ доступен или после чтения всего содержимого ответа).
- cancellationToken
- CancellationToken
Маркер отмены для отмены операции.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Значение request равно null.
Сообщение запроса уже отправлено экземпляром HttpClient .
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: время ожидания запроса.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
–или–
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. В зависимости от значения completionOption параметра возвращаемый Task<TResult> объект завершится сразу после того, как ответ будет доступен или весь ответ, включая содержимое.
Note
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Send(HttpRequestMessage, HttpCompletionOption).
Применяется к
SendAsync(HttpRequestMessage)
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
Отправка HTTP-запроса в виде асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request);override this.SendAsync : System.Net.Http.HttpRequestMessage -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage) As Task(Of HttpResponseMessage)Параметры
- request
- HttpRequestMessage
Сообщение HTTP-запроса для отправки.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Значение request равно null.
Сообщение запроса уже отправлено экземпляром HttpClient .
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: истекло время ожидания запроса.
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после того, как весь ответ, включая содержимое, будет считываться. Это же поведение, как если бы ResponseContentRead оно было явно указано.
Note
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Send(HttpRequestMessage).
Применяется к
SendAsync(HttpRequestMessage, HttpCompletionOption)
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
Отправка HTTP-запроса в виде асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Параметры
- request
- HttpRequestMessage
Сообщение HTTP-запроса для отправки.
- completionOption
- HttpCompletionOption
Когда операция должна завершиться (как только ответ доступен или после чтения всего содержимого ответа).
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Значение request равно null.
Сообщение запроса уже отправлено экземпляром HttpClient .
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: истекло время ожидания запроса.
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. В зависимости от значения completionOption параметра возвращаемый Task<TResult> объект завершится сразу после того, как ответ будет доступен или весь ответ, включая содержимое.
Note
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Send(HttpRequestMessage, HttpCompletionOption).
Применяется к
SendAsync(HttpRequestMessage, CancellationToken)
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
Отправка HTTP-запроса в виде асинхронной операции.
public:
override System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync(System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Overrides Function SendAsync (request As HttpRequestMessage, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Параметры
- request
- HttpRequestMessage
Сообщение HTTP-запроса для отправки.
- cancellationToken
- CancellationToken
Маркер отмены для отмены операции.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Значение request равно null.
Сообщение запроса уже отправлено экземпляром HttpClient .
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: истекло время ожидания запроса.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
–или–
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после того, как весь ответ, включая содержимое, будет считываться. Это же поведение, как если бы ResponseContentRead оно было явно указано.
Note
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Send(HttpRequestMessage).
