HttpClient.PostAsync(Uri, IHttpContent) Метод

  • Ссылка

Определение

Пространство имен:
Windows.Web.Http
Изменить

Отправка запроса 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)

Параметры

uri
Uri Uri

URI, куда отправляется запрос.

content
IHttpContent

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

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

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

Объект , представляющий асинхронную операцию.

Атрибуты
RemoteAsyncAttribute

Примеры

Примеры вызова HttpClient.PostAsync см. в статье HttpClient.

Комментарии

Эта операция не блокируется. Возвращенный объект IAsyncOperationWithProgress (httpResponseMessage и HttpProgress) завершается после считывания всего ответа (включая содержимое).

Методы PostAsync и PutAsync позволяют задавать только ограниченное количество заголовков содержимого HTTP. В отличие от этого, метод SendRequestAsync позволяет задавать заголовки в сообщении запроса, а также в содержимом HTTP для отправки.

Ниже приведены исключения, создаваемые этой функцией.

E_INVALIDARG

Параметр URI был пустой ссылкой (Nothing в Visual Basic).

Обработка исключений.

При вызове этого метода необходимо написать код для обработки исключений. Исключения могут возникать из-за ошибок проверки параметров, ошибок разрешения имен и сетевых ошибок. Исключения из сетевых ошибок (например, потеря подключения, сбои подключения и сбои HTTP-сервера) могут произойти в любое время. В результате таких ошибок создаются исключения. Если приложение не обрабатывается, исключение может привести к завершению всего приложения средой выполнения. Дополнительные сведения об обработке исключений см. в разделе Обработка исключений в сетевых приложениях.

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

См. также раздел