HttpClient.PostAsync 方法

參考

定義

命名空間:: System.Net.Http

組件:: System.Net.Http.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

以非同步作業的方式，將 POST 要求傳送至指定的 URI。

多載

PostAsync(String, HttpContent, CancellationToken)	以非同步作業的方式，傳送 POST 要求和取消語彙基元。
PostAsync(Uri, HttpContent, CancellationToken)	以非同步作業的方式，傳送 POST 要求和取消語彙基元。
PostAsync(String, HttpContent)	以非同步作業的方式，將 POST 要求傳送至指定的 URI。
PostAsync(Uri, HttpContent)	以非同步作業的方式，將 POST 要求傳送至指定的 URI。

備註

這項作業不會封鎖。

PostAsync(String, HttpContent, CancellationToken)

來源:: HttpClient.cs

來源:: HttpClient.cs

來源:: HttpClient.cs

以非同步作業的方式，傳送 POST 要求和取消語彙基元。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);

member this.PostAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PostAsync (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

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

UriFormatException

提供的要求 URI 不是有效的相對或絕對 URI。

OperationCanceledException

取消令牌已取消。此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。傳回的 Task<TResult> 物件會在讀取完整的回應 (包括內容) 之後完成。

注意

如果逾時，不同的 .NET 實作會擲回不同的例外狀況。

HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
TaskCanceledException會在 .NET 5 和更新版本上擲回巢狀。TimeoutException

適用於

PostAsync(Uri, HttpContent, CancellationToken)

來源:: HttpClient.cs

來源:: HttpClient.cs

來源:: HttpClient.cs

以非同步作業的方式，傳送 POST 要求和取消語彙基元。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);

member this.PostAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PostAsync (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

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

OperationCanceledException

取消令牌已取消。此例外狀況會儲存在傳回的工作中。

備註

這項作業不會封鎖。傳回的 Task<TResult> 物件會在讀取完整的回應 (包括內容) 之後完成。

注意

如果逾時，不同的 .NET 實作會擲回不同的例外狀況。

HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
TaskCanceledException會在 .NET 5 和更新版本上擲回巢狀。TimeoutException

適用於

PostAsync(String, HttpContent)

來源:: HttpClient.cs

來源:: HttpClient.cs

來源:: HttpClient.cs

以非同步作業的方式，將 POST 要求傳送至指定的 URI。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent? content);

member this.PostAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PostAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)

參數

requestUri: String

傳送要求的目標 URI。

content: HttpContent

傳送至伺服器的 HTTP 要求內容。

傳回

Task<HttpResponseMessage>

工作物件，表示非同步作業。

例外狀況

InvalidOperationException

requestUri 必須是絕對 URI，否則必須設定 BaseAddress。

HttpRequestException

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

UriFormatException

提供的要求 URI 不是有效的相對或絕對 URI。

備註

這項作業不會封鎖。傳回的 Task<TResult> 物件會在讀取完整的回應 (包括內容) 之後完成。

注意

如果逾時，不同的 .NET 實作會擲回不同的例外狀況。

HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
TaskCanceledException會在 .NET 5 和更新版本上擲回巢狀。TimeoutException

適用於

PostAsync(Uri, HttpContent)

來源:: HttpClient.cs

來源:: HttpClient.cs

來源:: HttpClient.cs

以非同步作業的方式，將 POST 要求傳送至指定的 URI。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent? content);

member this.PostAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PostAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)

參數

requestUri: Uri

傳送要求的目標 URI。

content: HttpContent

傳送至伺服器的 HTTP 要求內容。

傳回

Task<HttpResponseMessage>

工作物件，表示非同步作業。

例外狀況

InvalidOperationException

requestUri 必須是絕對 URI，否則必須設定 BaseAddress。

HttpRequestException

要求已因基本問題 (例如網路連線、DNS 失敗、伺服器憑證驗證或逾時) 而失敗。

TaskCanceledException

僅限 .NET Core 和 .NET 5 和更新版本：要求因逾時而失敗。

備註

這項作業不會封鎖。傳回的 Task<TResult> 物件會在讀取完整的回應 (包括內容) 之後完成。

注意

如果逾時，不同的 .NET 實作會擲回不同的例外狀況。

HttpRequestException會在所有適用的 .NET Framework 版本上擲回。
TaskCanceledException 所有適用的 .NET Core 版本都會擲回沒有任何內部例外狀況。
TaskCanceledException會在 .NET 5 和更新版本上擲回巢狀。TimeoutException

適用於

共用方式為

HttpClient.PostAsync 方法

定義

多載

備註

PostAsync(String, HttpContent, CancellationToken)

參數

傳回

例外狀況

備註

適用於

PostAsync(Uri, HttpContent, CancellationToken)

參數

傳回

例外狀況

備註

適用於

PostAsync(String, HttpContent)

參數

傳回

例外狀況

備註

適用於

PostAsync(Uri, HttpContent)

參數

傳回

例外狀況

備註

適用於

其他資源