HttpClient.PostAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отправьте запрос POST в указанный URI в качестве асинхронной операции.
Перегрузки
| Имя | Описание |
|---|---|
| PostAsync(Uri, HttpContent, CancellationToken) |
Отправьте запрос POST с маркером отмены в виде асинхронной операции. |
| PostAsync(String, HttpContent, CancellationToken) |
Отправьте запрос POST с маркером отмены в виде асинхронной операции. |
| PostAsync(String, HttpContent) |
Отправьте запрос POST в указанный URI в качестве асинхронной операции. |
| PostAsync(Uri, HttpContent) |
Отправьте запрос POST в указанный URI в качестве асинхронной операции. |
Комментарии
Эта операция не блокируется.
PostAsync(Uri, HttpContent, CancellationToken)
Отправьте запрос POST с маркером отмены в виде асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync(Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);member this.PostAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Параметры
- requestUri
- Uri
URI, в который отправляется запрос.
- content
- HttpContent
Содержимое HTTP-запроса, отправленное серверу.
- cancellationToken
- CancellationToken
Маркер отмены, который можно использовать другими объектами или потоками для получения уведомления об отмене.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: истекло время ожидания запроса.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
–или–
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после чтения всего ответа (включая содержимое).
Note
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Применяется к
PostAsync(String, HttpContent, CancellationToken)
Отправьте запрос POST с маркером отмены в виде асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync(string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);member this.PostAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Параметры
- requestUri
- String
URI, в который отправляется запрос.
- content
- HttpContent
Содержимое HTTP-запроса, отправленное серверу.
- cancellationToken
- CancellationToken
Маркер отмены, который можно использовать другими объектами или потоками для получения уведомления об отмене.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: истекло время ожидания запроса.
Предоставленный URI запроса не является допустимым относительным или абсолютным универсальным кодом ресурса (URI).
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
–или–
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после чтения всего ответа (включая содержимое).
Note
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Применяется к
PostAsync(String, HttpContent)
Отправьте запрос POST в указанный URI в качестве асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync(string requestUri, System.Net.Http.HttpContent content);member this.PostAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)Параметры
- requestUri
- String
URI, в который отправляется запрос.
- content
- HttpContent
Содержимое HTTP-запроса, отправленное серверу.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: истекло время ожидания запроса.
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Предоставленный URI запроса не является допустимым относительным или абсолютным универсальным кодом ресурса (URI).
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после чтения всего ответа (включая содержимое).
Note
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.
Применяется к
PostAsync(Uri, HttpContent)
Отправьте запрос POST в указанный URI в качестве асинхронной операции.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync(Uri requestUri, System.Net.Http.HttpContent content);member this.PostAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)Параметры
- requestUri
- Uri
URI, в который отправляется запрос.
- content
- HttpContent
Содержимое HTTP-запроса, отправленное серверу.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию.
Исключения
Не requestUri является абсолютным универсальным кодом ресурса (URI) и BaseAddress не задан.
Сбой запроса из-за проблемы с получением допустимого HTTP-ответа, например сбой сетевого подключения, сбой DNS, ошибка проверки сертификата сервера или недопустимый ответ сервера. На .NET 8 и более поздних версиях причина указывается HttpRequestError
–или–
только .NET Framework: истекло время ожидания запроса.
.NET Core и .NET 5 и более поздних версий: запрос завершился ошибкой из-за времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после чтения всего ответа (включая содержимое).
Note
При истечении времени ожидания в разных реализациях .NET создаются различные исключения.
- HttpRequestException создается во всех применимых версиях .NET Framework.
- OperationCanceledException без внутреннего исключения создается во всех применимых версиях .NET Core.
- OperationCanceledException, вложенной в TimeoutException, создается на .NET 5 и более поздних версиях.