Поделиться через


HttpClient.PutAsync Метод

Определение

Отправка запроса PUT по указанному универсальному коду ресурса (URI) в качестве асинхронной операции.

Перегрузки

PutAsync(String, HttpContent)

Отправка запроса PUT по указанному универсальному коду ресурса (URI) в качестве асинхронной операции.

PutAsync(Uri, HttpContent)

Отправка запроса PUT по указанному универсальному коду ресурса (URI) в качестве асинхронной операции.

PutAsync(String, HttpContent, CancellationToken)

Отправка запроса PUT с токеном отмены в качестве асинхронной операции.

PutAsync(Uri, HttpContent, CancellationToken)

Отправка запроса PUT с токеном отмены в качестве асинхронной операции.

Комментарии

Эта операция не блокируется.

PutAsync(String, HttpContent)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

Отправка запроса PUT по указанному универсальному коду ресурса (URI) в качестве асинхронной операции.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string? requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string? requestUri, System.Net.Http.HttpContent? content);
member this.PutAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PutAsync (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 и более поздних версиях.

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

PutAsync(Uri, HttpContent)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

Отправка запроса PUT по указанному универсальному коду ресурса (URI) в качестве асинхронной операции.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri? requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri? requestUri, System.Net.Http.HttpContent? content);
member this.PutAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PutAsync (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 и более поздних версиях.

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

PutAsync(String, HttpContent, CancellationToken)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

Отправка запроса PUT с токеном отмены в качестве асинхронной операции.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);
member this.PutAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PutAsync (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 и более поздних версиях.

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

PutAsync(Uri, HttpContent, CancellationToken)

Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs
Исходный код:
HttpClient.cs

Отправка запроса PUT с токеном отмены в качестве асинхронной операции.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);
member this.PutAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PutAsync (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 и более поздних версиях.

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