HttpClientJsonExtensions.PostAsJsonAsync 方法
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
| PostAsJsonAsync<TValue>(HttpClient, String, TValue, CancellationToken) |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 |
| PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, CancellationToken) |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 |
| PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonSerializerOptions, CancellationToken) |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 |
| PostAsJsonAsync<TValue>(HttpClient, String, TValue, JsonTypeInfo<TValue>, CancellationToken) |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 |
| PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonSerializerOptions, CancellationToken) |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 |
| PostAsJsonAsync<TValue>(HttpClient, Uri, TValue, JsonTypeInfo<TValue>, CancellationToken) |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 value。
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsJsonAsync(System::Net::Http::HttpClient ^ client, System::String ^ requestUri, TValue value, System::Threading::CancellationToken cancellationToken);C#
public static System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsJsonAsync<TValue> (this System.Net.Http.HttpClient client, string? requestUri, TValue value, System.Threading.CancellationToken cancellationToken);static member PostAsJsonAsync : System.Net.Http.HttpClient * string * 'Value * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage><Extension()>
Public Function PostAsJsonAsync(Of TValue) (client As HttpClient, requestUri As String, value As TValue, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)類型參數
- TValue
要序列化之值的類型。
參數
- client
- HttpClient
用來傳送要求的用戶端。
- requestUri
- String
傳送要求的目標 URI。
- value
- TValue
要序列化的值。
- cancellationToken
- CancellationToken
取消語彙基元，可由其他物件或執行緒用來接收取消通知。
傳回
工作物件，表示非同步作業。
例外狀況
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
備註
這個方法預設會使用 JsonSerializerDefaults.Web 串行化的選項，而 JsonSerializer 串行化方法預設不會。
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | 5, 6, 7, 8, 9 |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 value。
public:
generic <typename TValue>
[System::Runtime::CompilerServices::Extension]
static System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsJsonAsync(System::Net::Http::HttpClient ^ client, Uri ^ requestUri, TValue value, System::Threading::CancellationToken cancellationToken);C#
public static System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsJsonAsync<TValue> (this System.Net.Http.HttpClient client, Uri? requestUri, TValue value, System.Threading.CancellationToken cancellationToken);static member PostAsJsonAsync : System.Net.Http.HttpClient * Uri * 'Value * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage><Extension()>
Public Function PostAsJsonAsync(Of TValue) (client As HttpClient, requestUri As Uri, value As TValue, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)類型參數
- TValue
要序列化之值的類型。
參數
- client
- HttpClient
用來傳送要求的用戶端。
- requestUri
- Uri
傳送要求的目標 URI。
- value
- TValue
要序列化的值。
- cancellationToken
- CancellationToken
取消語彙基元，可由其他物件或執行緒用來接收取消通知。
傳回
工作物件，表示非同步作業。
例外狀況
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
備註
這個方法預設會使用 JsonSerializerDefaults.Web 串行化的選項，而 JsonSerializer 串行化方法預設不會。
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | 5, 6, 7, 8, 9 |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 value。
C#
public static System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsJsonAsync<TValue> (this System.Net.Http.HttpClient client, string? requestUri, TValue value, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);static member PostAsJsonAsync : System.Net.Http.HttpClient * string * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage><Extension()>
Public Function PostAsJsonAsync(Of TValue) (client As HttpClient, requestUri As String, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpResponseMessage)類型參數
- TValue
要序列化之值的類型。
參數
- client
- HttpClient
用來傳送要求的用戶端。
- requestUri
- String
傳送要求的目標 URI。
- value
- TValue
要序列化的值。
- options
- JsonSerializerOptions
在串行化期間控制行為的選項。 預設選項是 Web 所指定的選項。
- cancellationToken
- CancellationToken
取消語彙基元，可由其他物件或執行緒用來接收取消通知。
傳回
工作物件，表示非同步作業。
例外狀況
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | 5, 6, 7, 8, 9 |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 value。
C#
public static System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsJsonAsync<TValue> (this System.Net.Http.HttpClient client, string? requestUri, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member PostAsJsonAsync : System.Net.Http.HttpClient * string * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage><Extension()>
Public Function PostAsJsonAsync(Of TValue) (client As HttpClient, requestUri As String, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpResponseMessage)類型參數
- TValue
要序列化之值的類型。
參數
- client
- HttpClient
用來傳送要求的用戶端。
- requestUri
- String
傳送要求的目標 URI。
- value
- TValue
要序列化的值。
- jsonTypeInfo
- JsonTypeInfo<TValue>
用來控制串行化行為的 JsonTypeInfo。
- cancellationToken
- CancellationToken
取消語彙基元，可由其他物件或執行緒用來接收取消通知。
傳回
工作物件，表示非同步作業。
例外狀況
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | 6, 7, 8, 9 |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 value。
C#
public static System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsJsonAsync<TValue> (this System.Net.Http.HttpClient client, Uri? requestUri, TValue value, System.Text.Json.JsonSerializerOptions? options = default, System.Threading.CancellationToken cancellationToken = default);static member PostAsJsonAsync : System.Net.Http.HttpClient * Uri * 'Value * System.Text.Json.JsonSerializerOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage><Extension()>
Public Function PostAsJsonAsync(Of TValue) (client As HttpClient, requestUri As Uri, value As TValue, Optional options As JsonSerializerOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpResponseMessage)類型參數
- TValue
要序列化之值的類型。
參數
- client
- HttpClient
用來傳送要求的用戶端。
- requestUri
- Uri
傳送要求的目標 URI。
- value
- TValue
要序列化的值。
- options
- JsonSerializerOptions
在串行化期間控制行為的選項。 預設選項是 Web 所指定的選項。
- cancellationToken
- CancellationToken
取消語彙基元，可由其他物件或執行緒用來接收取消通知。
傳回
工作物件，表示非同步作業。
例外狀況
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | 5, 6, 7, 8, 9 |
將 POST 要求傳送至指定的 URI，其中要求本文包含序列化為 JSON 的 value。
C#
public static System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsJsonAsync<TValue> (this System.Net.Http.HttpClient client, Uri? requestUri, TValue value, System.Text.Json.Serialization.Metadata.JsonTypeInfo<TValue> jsonTypeInfo, System.Threading.CancellationToken cancellationToken = default);static member PostAsJsonAsync : System.Net.Http.HttpClient * Uri * 'Value * System.Text.Json.Serialization.Metadata.JsonTypeInfo<'Value> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage><Extension()>
Public Function PostAsJsonAsync(Of TValue) (client As HttpClient, requestUri As Uri, value As TValue, jsonTypeInfo As JsonTypeInfo(Of TValue), Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpResponseMessage)類型參數
- TValue
要序列化之值的類型。
參數
- client
- HttpClient
用來傳送要求的用戶端。
- requestUri
- Uri
傳送要求的目標 URI。
- value
- TValue
要序列化的值。
- jsonTypeInfo
- JsonTypeInfo<TValue>
用來控制串行化行為的 JsonTypeInfo。
- cancellationToken
- CancellationToken
取消語彙基元，可由其他物件或執行緒用來接收取消通知。
傳回
工作物件，表示非同步作業。
例外狀況
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
適用於
.NET 9 及其他版本
| 產品 | 版本 |
|---|---|
| .NET | 6, 7, 8, 9 |
