HttpClient.PostAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
非同期操作として、指定した URI に POST 要求を送信します。
オーバーロード
| 名前 | 説明 |
|---|---|
| PostAsync(Uri, HttpContent, CancellationToken) |
キャンセル トークンを使用して POST 要求を非同期操作として送信します。 |
| PostAsync(String, HttpContent, CancellationToken) |
キャンセル トークンを使用して POST 要求を非同期操作として送信します。 |
| PostAsync(String, HttpContent) |
非同期操作として、指定した URI に POST 要求を送信します。 |
| PostAsync(Uri, HttpContent) |
非同期操作として、指定した URI に POST 要求を送信します。 |
注釈
この操作はブロックされません。
PostAsync(Uri, HttpContent, CancellationToken)
キャンセル トークンを使用して 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);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
他のオブジェクトまたはスレッドが取り消し通知を受け取るために使用できるキャンセル トークン。
返品
非同期操作を表すタスク オブジェクト。
例外
requestUriは絶対 URI ではなく、BaseAddressは設定されていません。
ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
-または-
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
適用対象
PostAsync(String, HttpContent, CancellationToken)
キャンセル トークンを使用して 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);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
他のオブジェクトまたはスレッドが取り消し通知を受け取るために使用できるキャンセル トークン。
返品
非同期操作を表すタスク オブジェクト。
例外
requestUriは絶対 URI ではなく、BaseAddressは設定されていません。
ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
指定された要求 URI が有効な相対 URI または絶対 URI ではありません。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
-または-
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
適用対象
PostAsync(String, HttpContent)
非同期操作として、指定した URI に POST 要求を送信します。
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);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 要求コンテンツ。
返品
非同期操作を表すタスク オブジェクト。
例外
requestUriは絶対 URI ではなく、BaseAddressは設定されていません。
ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
指定された要求 URI が有効な相対 URI または絶対 URI ではありません。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
適用対象
PostAsync(Uri, HttpContent)
非同期操作として、指定した URI に POST 要求を送信します。
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 要求コンテンツ。
返品
非同期操作を表すタスク オブジェクト。
例外
requestUriは絶対 URI ではなく、BaseAddressは設定されていません。
ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。