HttpClient.PostAsync(Uri, IHttpContent) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отправка запроса POST на указанный URI в качестве асинхронной операции. Рекомендации по программированию для класса HttpClient и примеры кода см. в разделе Основные сведения о HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ PostAsync(Uri ^ uri, IHttpContent ^ content) = PostAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> PostAsync(Uri const& uri, IHttpContent const& content);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> PostAsync(System.Uri uri, IHttpContent content);function postAsync(uri, content)Public Function PostAsync (uri As Uri, content As IHttpContent) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)Параметры
- content
- IHttpContent
Содержимое HTTP-запроса для отправки на сервер.
Возвращаемое значение
Объект , представляющий асинхронную операцию.
- Атрибуты
Примеры
Примеры вызова HttpClient.PostAsync см. в статье HttpClient.
Комментарии
Эта операция не блокируется. Возвращенный объект IAsyncOperationWithProgress (httpResponseMessage и HttpProgress) завершается после считывания всего ответа (включая содержимое).
Методы PostAsync и PutAsync позволяют задавать только ограниченное количество заголовков содержимого HTTP. В отличие от этого, метод SendRequestAsync позволяет задавать заголовки в сообщении запроса, а также в содержимом HTTP для отправки.
Ниже приведены исключения, создаваемые этой функцией.
E_INVALIDARG
Параметр URI был пустой ссылкой (Nothing в Visual Basic).
Обработка исключений.
При вызове этого метода необходимо написать код для обработки исключений. Исключения могут возникать из-за ошибок проверки параметров, ошибок разрешения имен и сетевых ошибок. Исключения из сетевых ошибок (например, потеря подключения, сбои подключения и сбои HTTP-сервера) могут произойти в любое время. В результате таких ошибок создаются исключения. Если приложение не обрабатывается, исключение может привести к завершению всего приложения средой выполнения. Дополнительные сведения об обработке исключений см. в разделе Обработка исключений в сетевых приложениях.