HttpClient.DeleteAsync 方法

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

以非同步操作方式向指定的 URI 發送 DELETE 請求。

多載

名稱	Description
DeleteAsync(String)	以非同步操作方式向指定的 URI 發送 DELETE 請求。
DeleteAsync(Uri)	以非同步操作方式向指定的 URI 發送 DELETE 請求。
DeleteAsync(String, CancellationToken)	以非同步操作向指定的 URI 發送 DELETE 請求，並使用取消權杖。
DeleteAsync(Uri, CancellationToken)	以非同步操作向指定的 URI 發送 DELETE 請求，並使用取消權杖。

DeleteAsync(String)

以非同步操作方式向指定的 URI 發送 DELETE 請求。

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 並不是絕對的上呼吸道。

-或-

BaseAddress 未設定。

HttpRequestException

請求失敗是因為無法取得有效的 HTTP 回應，例如網路連線失敗、DNS 故障、伺服器憑證驗證錯誤或伺服器回應無效。 在.NET 8及以後版本中，原因以HttpRequestError表示。

-或-

僅限 .NET 框架：請求已逾時。

OperationCanceledException

僅 .NET Core 及 .NET 5 及以後版本：因逾時而請求失敗。

備註

這個操作不會阻擋。 回傳 Task<TResult> 的物件會在整個回應（包括內容）被讀取後完成。

Note

若逾時，會對不同的 .NET 實作拋出不同的例外：

• OperationCanceledException 巢狀的 TimeoutException 會丟.NET 5 及以後版本。
• OperationCanceledException 在所有適用的 .NET Core 版本中，且無任何內部例外。
• HttpRequestException 會被丟在所有適用的 .NET Framework 版本上。

DeleteAsync(Uri)

以非同步操作方式向指定的 URI 發送 DELETE 請求。

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 並不是絕對的上呼吸道。

-或-

BaseAddress 未設定。

HttpRequestException

請求失敗是因為無法取得有效的 HTTP 回應，例如網路連線失敗、DNS 故障、伺服器憑證驗證錯誤或伺服器回應無效。 在 .NET 8 及以後版本中，原因以 HttpRequestError 表示

-或-

僅限 .NET Framework 使用：請求已逾時。

OperationCanceledException

僅 .NET Core 及 .NET 5 及以後版本：因逾時而請求失敗。

備註

這個操作不會阻擋。 回傳 Task<TResult> 的物件會在整個回應（包括內容）被讀取後完成。

Note

若逾時，會對不同的 .NET 實作拋出不同的例外：

• OperationCanceledException 巢狀的 TimeoutException 會丟.NET 5 及以後版本。
• OperationCanceledException 在所有適用的 .NET Core 版本中，且無任何內部例外。
• HttpRequestException 會被丟在所有適用的 .NET Framework 版本上。

DeleteAsync(String, CancellationToken)

以非同步操作向指定的 URI 發送 DELETE 請求，並使用取消權杖。

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 並不是絕對的上呼吸道。

-或-

BaseAddress 未設定。

HttpRequestException

請求失敗是因為無法取得有效的 HTTP 回應，例如網路連線失敗、DNS 故障、伺服器憑證驗證錯誤或伺服器回應無效。 在 .NET 8 及以後版本中，原因以 HttpRequestError 表示

-或-

僅限 .NET Framework 使用：請求已逾時。

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

-或-

僅 .NET Core 及 .NET 5 及以後版本：因逾時而請求失敗。

備註

這個操作不會阻擋。 回傳 Task<TResult> 的物件會在整個回應（包括內容）被讀取後完成。

Note

若逾時，會對不同的 .NET 實作拋出不同的例外。

• OperationCanceledException 巢狀的 TimeoutException 會丟.NET 5 及以後版本。
• OperationCanceledException 在所有適用的 .NET Core 版本中，且無任何內部例外。
• HttpRequestException 會被丟在所有適用的 .NET Framework 版本上。

DeleteAsync(Uri, CancellationToken)

以非同步操作向指定的 URI 發送 DELETE 請求，並使用取消權杖。

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 並不是絕對的上呼吸道。

-或-

BaseAddress 未設定。

HttpRequestException

請求失敗是因為無法取得有效的 HTTP 回應，例如網路連線失敗、DNS 故障、伺服器憑證驗證錯誤或伺服器回應無效。 在 .NET 8 及以後版本中，原因以 HttpRequestError 表示

-或-

僅限 .NET Framework 使用：請求已逾時。

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

-或-

僅 .NET Core 及 .NET 5 及以後版本：因逾時而請求失敗。

備註

這個操作不會阻擋。 回傳 Task<TResult> 的物件會在整個回應（包括內容）被讀取後完成。

Note

若逾時，會對不同的 .NET 實作拋出不同的例外。

• HttpRequestException 會被丟在所有適用的 .NET Framework 版本上。
• OperationCanceledException 在所有適用的 .NET Core 版本中，且無任何內部例外。
• OperationCanceledException 巢狀的 TimeoutException 會丟.NET 5 及以後版本。