HttpClient.PutAsync 方法

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

將 PUT 請求傳送給指定的 URI，作為非同步操作。

多載

名稱	Description
PutAsync(String, HttpContent)	將 PUT 請求傳送給指定的 URI，作為非同步操作。
PutAsync(Uri, HttpContent)	將 PUT 請求傳送給指定的 URI，作為非同步操作。
PutAsync(String, HttpContent, CancellationToken)	以非同步操作發送帶有取消權杖的 PUT 請求。
PutAsync(Uri, HttpContent, CancellationToken)	以非同步操作發送帶有取消權杖的 PUT 請求。

備註

這個操作不會阻擋。

PutAsync(String, HttpContent)

將 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);

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 請求內容。

傳回

Task<HttpResponseMessage>

表示異步操作的工作物件。

例外狀況

InvalidOperationException

這 requestUri 不是絕對的 URI，也 BaseAddress 沒有設定好。

HttpRequestException

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

-或-

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

OperationCanceledException

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

UriFormatException

所提供的請求 URI 既非有效的相對 URI，也非絕對 URI。

備註

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

Note

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

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

PutAsync(Uri, HttpContent)

將 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);

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 請求內容。

傳回

Task<HttpResponseMessage>

表示異步操作的工作物件。

例外狀況

InvalidOperationException

這 requestUri 不是絕對的 URI，也 BaseAddress 沒有設定好。

HttpRequestException

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

-或-

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

OperationCanceledException

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

備註

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

Note

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

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

PutAsync(String, HttpContent, CancellationToken)

以非同步操作發送帶有取消權杖的 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);

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

一種可被其他物件或執行緒用來接收取消通知的取消標記。

傳回

Task<HttpResponseMessage>

表示異步操作的工作物件。

例外狀況

InvalidOperationException

這 requestUri 不是絕對的 URI，也 BaseAddress 沒有設定好。

HttpRequestException

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

-或-

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

UriFormatException

所提供的請求 URI 既非有效的相對 URI，也非絕對 URI。

OperationCanceledException

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

-或-

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

備註

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

Note

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

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

PutAsync(Uri, HttpContent, CancellationToken)

以非同步操作發送帶有取消權杖的 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);

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

一種可被其他物件或執行緒用來接收取消通知的取消標記。

傳回

Task<HttpResponseMessage>

表示異步操作的工作物件。

例外狀況

InvalidOperationException

這 requestUri 不是絕對的 URI，也 BaseAddress 沒有設定好。

HttpRequestException

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

-或-

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

OperationCanceledException

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

-或-

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

備註

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

Note

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

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