HttpClient.PostAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отправка запроса POST по указанному универсальному коду ресурса (URI) в качестве асинхронной операции.
Перегрузки
PostAsync(String, HttpContent, CancellationToken) |
Отправка запроса POST с токеном отмены в качестве асинхронной операции. |
PostAsync(Uri, HttpContent, CancellationToken) |
Отправка запроса POST с токеном отмены в качестве асинхронной операции. |
PostAsync(String, HttpContent) |
Отправка запроса POST по указанному универсальному коду ресурса (URI) в качестве асинхронной операции. |
PostAsync(Uri, HttpContent) |
Отправка запроса POST по указанному универсальному коду ресурса (URI) в качестве асинхронной операции. |
Комментарии
Эта операция не блокируется.
PostAsync(String, HttpContent, CancellationToken)
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
Отправка запроса 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);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (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.
Не удалось выполнить запрос из-за ключевой проблемы, например подключения к сети, ошибки DNS, проверки сертификата сервера или времени ожидания.
Только .NET Core и .NET 5 и более поздних версий: запрос завершился сбоем из-за истечения времени ожидания.
Указанный URI запроса не является допустимым относительным или абсолютным URI.
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего ответа (включая содержимое).
Примечание
В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.
- HttpRequestExceptionвозникает во всех применимых версиях платформа .NET Framework.
- TaskCanceledException во всех применимых версиях .NET Core возникает исключение без каких-либо внутренних исключений.
- TaskCanceledException объект , вложенный в TimeoutException , создается в .NET 5 и более поздних версиях.
Применяется к
PostAsync(Uri, HttpContent, CancellationToken)
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
Отправка запроса 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);
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.
Не удалось выполнить запрос из-за ключевой проблемы, например подключения к сети, ошибки DNS, проверки сертификата сервера или времени ожидания.
Только .NET Core и .NET 5 и более поздних версий: запрос завершился сбоем из-за истечения времени ожидания.
Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего ответа (включая содержимое).
Примечание
В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.
- HttpRequestExceptionвозникает во всех применимых версиях платформа .NET Framework.
- TaskCanceledException во всех применимых версиях .NET Core возникает исключение без каких-либо внутренних исключений.
- TaskCanceledException объект , вложенный в TimeoutException , создается в .NET 5 и более поздних версиях.
Применяется к
PostAsync(String, HttpContent)
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
Отправка запроса 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);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (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.
Не удалось выполнить запрос из-за ключевой проблемы, например подключения к сети, ошибки DNS, проверки сертификата сервера или времени ожидания.
Только .NET Core и .NET 5 и более поздних версий: запрос завершился сбоем из-за истечения времени ожидания.
Указанный URI запроса не является допустимым относительным или абсолютным URI.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего ответа (включая содержимое).
Примечание
В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.
- HttpRequestExceptionвозникает во всех применимых версиях платформа .NET Framework.
- TaskCanceledException во всех применимых версиях .NET Core возникает исключение без каких-либо внутренних исключений.
- TaskCanceledException объект , вложенный в TimeoutException , создается в .NET 5 и более поздних версиях.
Применяется к
PostAsync(Uri, HttpContent)
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
- Исходный код:
- HttpClient.cs
Отправка запроса 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);
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.
Не удалось выполнить запрос из-за ключевой проблемы, например подключения к сети, ошибки DNS, проверки сертификата сервера или времени ожидания.
Только .NET Core и .NET 5 и более поздних версий: запрос завершился сбоем из-за истечения времени ожидания.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после считывания всего ответа (включая содержимое).
Примечание
В случае истечения времени ожидания в разных реализациях .NET создаются разные исключения.
- HttpRequestExceptionвозникает во всех применимых версиях платформа .NET Framework.
- TaskCanceledException во всех применимых версиях .NET Core возникает исключение без каких-либо внутренних исключений.
- TaskCanceledException объект , вложенный в TimeoutException , создается в .NET 5 и более поздних версиях.