HttpClient.DeleteAsync 方法

定义

命名空间:

System.Net.Http

程序集:

System.Net.Http.dll

以异步操作将 DELETE 请求发送给指定 URI。

重载

DeleteAsync(String)	以异步操作将 DELETE 请求发送给指定 URI。
DeleteAsync(Uri)	以异步操作将 DELETE 请求发送给指定 URI。
DeleteAsync(String, CancellationToken)	用以异步操作的取消标记发送 DELETE 请求到指定的 URI。
DeleteAsync(Uri, CancellationToken)	用以异步操作的取消标记发送 DELETE 请求到指定的 URI。

DeleteAsync(String)

Source:

HttpClient.cs

以异步操作将 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。

返回

Task<HttpResponseMessage>

表示异步操作的任务对象。

例外

InvalidOperationException

请求消息已由 HttpClient 实例发送。

或

requestUri 不是一个绝对 URI。

或

未设置 BaseAddress。

HttpRequestException

由于基础问题（如网络连接性、DNS 失败、服务器证书验证或超时），请求失败。

TaskCanceledException

仅限 .NET Core 和 .NET 5 及更高版本：请求因超时而失败。

注解

此操作不会阻止。 返回的对象 Task<TResult> 将在读取整个响应 (包括内容) 后完成。

注意

如果出现超时，则会在不同的 .NET 实现上引发不同的异常。

• HttpRequestException在所有适用的 .NET Framework 版本上引发 。
• TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
• TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。

DeleteAsync(Uri)

Source:

HttpClient.cs

以异步操作将 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。

返回

Task<HttpResponseMessage>

表示异步操作的任务对象。

例外

InvalidOperationException

请求消息已由 HttpClient 实例发送。

或

requestUri 不是一个绝对 URI。

或

未设置 BaseAddress。

HttpRequestException

由于基础问题（如网络连接性、DNS 失败、服务器证书验证或超时），请求失败。

TaskCanceledException

仅限 .NET Core 和 .NET 5 及更高版本：请求因超时而失败。

注解

此操作不会阻止。 返回的对象 Task<TResult> 将在读取整个响应 (包括内容) 后完成。

注意

如果出现超时，则会在不同的 .NET 实现上引发不同的异常。

• HttpRequestException在所有适用的 .NET Framework 版本上引发 。
• TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
• TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。

DeleteAsync(String, CancellationToken)

Source:

HttpClient.cs

用以异步操作的取消标记发送 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

可由其他对象或线程用以接收取消通知的取消标记。

返回

Task<HttpResponseMessage>

表示异步操作的任务对象。

例外

InvalidOperationException

请求消息已由 HttpClient 实例发送。

或

requestUri 不是一个绝对 URI。

或

未设置 BaseAddress。

HttpRequestException

由于基础问题（如网络连接性、DNS 失败、服务器证书验证或超时），请求失败。

TaskCanceledException

仅限 .NET Core 和 .NET 5 及更高版本：请求因超时而失败。

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

此操作不会阻止。 返回的对象 Task<TResult> 将在读取整个响应 (包括内容) 后完成。

注意

如果出现超时，则会在不同的 .NET 实现上引发不同的异常。

• HttpRequestException在所有适用的 .NET Framework 版本上引发 。
• TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
• TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。

DeleteAsync(Uri, CancellationToken)

Source:

HttpClient.cs

用以异步操作的取消标记发送 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

可由其他对象或线程用以接收取消通知的取消标记。

返回

Task<HttpResponseMessage>

表示异步操作的任务对象。

例外

InvalidOperationException

请求消息已由 HttpClient 实例发送。

或

requestUri 不是一个绝对 URI。

或

未设置 BaseAddress。

HttpRequestException

由于基础问题（如网络连接性、DNS 失败、服务器证书验证或超时），请求失败。

TaskCanceledException

仅限 .NET Core 和 .NET 5 及更高版本：请求因超时而失败。

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

注解

此操作不会阻止。 返回的对象 Task<TResult> 将在读取整个响应 (包括内容) 后完成。

注意

如果出现超时，则会在不同的 .NET 实现上引发不同的异常。

• HttpRequestException在所有适用的 .NET Framework 版本上引发 。
• TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
• TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的 。