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