HttpClient.SendAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
非同期操作として HTTP 要求を送信します。
オーバーロード
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
非同期操作として HTTP 要求を送信します。 |
| SendAsync(HttpRequestMessage) |
非同期操作として HTTP 要求を送信します。 |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
非同期操作として HTTP 要求を送信します。 |
| SendAsync(HttpRequestMessage, CancellationToken) |
非同期操作として HTTP 要求を送信します。 |
注釈
この操作はブロックされません。
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
非同期操作として HTTP 要求を送信します。
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)パラメーター
- request
- HttpRequestMessage
送信する HTTP 要求メッセージ。
- completionOption
- HttpCompletionOption
操作が完了したとき (応答が使用できる状態になった後か、応答コンテンツ全体が読み取られた後)。
- cancellationToken
- CancellationToken
操作をキャンセルするキャンセル トークン。
戻り値
非同期操作を表すタスク オブジェクト。
例外
request が null です。
要求メッセージは HttpClient インスタンスによって既に送信されました。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 パラメーターの completionOption 値に応じて、返される Task<TResult> オブジェクトは、応答が使用可能になったり、コンテンツを含む応答全体が読み取られたりするとすぐに完了します。
注意
タイムアウトの場合、.NET 実装ごとに異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでがスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Send(HttpRequestMessage, HttpCompletionOption)スローされる例外に関するページを参照してください。
適用対象
SendAsync(HttpRequestMessage)
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
非同期操作として HTTP 要求を送信します。
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request);override this.SendAsync : System.Net.Http.HttpRequestMessage -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage) As Task(Of HttpResponseMessage)パラメーター
- request
- HttpRequestMessage
送信する HTTP 要求メッセージ。
戻り値
非同期操作を表すタスク オブジェクト。
例外
request が null です。
要求メッセージは HttpClient インスタンスによって既に送信されました。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、コンテンツを含む応答全体が読み取られた後に完了します。 動作は、 が明示的に指定されている場合 ResponseContentRead と同じです。
注意
タイムアウトの場合、.NET 実装ごとに異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでがスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Send(HttpRequestMessage)スローされる例外に関するページを参照してください。
適用対象
SendAsync(HttpRequestMessage, HttpCompletionOption)
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
非同期操作として HTTP 要求を送信します。
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)パラメーター
- request
- HttpRequestMessage
送信する HTTP 要求メッセージ。
- completionOption
- HttpCompletionOption
操作が完了したとき (応答が使用できる状態になった後か、応答コンテンツ全体が読み取られた後)。
戻り値
非同期操作を表すタスク オブジェクト。
例外
request が null です。
要求メッセージは HttpClient インスタンスによって既に送信されました。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
注釈
この操作はブロックされません。 パラメーターの completionOption 値に応じて、返される Task<TResult> オブジェクトは、応答が使用可能になったり、コンテンツを含む応答全体が読み取られたりするとすぐに完了します。
注意
タイムアウトの場合、.NET 実装ごとに異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでがスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Send(HttpRequestMessage, HttpCompletionOption)スローされる例外に関するページを参照してください。
適用対象
SendAsync(HttpRequestMessage, CancellationToken)
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
非同期操作として HTTP 要求を送信します。
public:
override System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Overrides Function SendAsync (request As HttpRequestMessage, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)パラメーター
- request
- HttpRequestMessage
送信する HTTP 要求メッセージ。
- cancellationToken
- CancellationToken
操作をキャンセルするキャンセル トークン。
戻り値
非同期操作を表すタスク オブジェクト。
例外
request が null です。
要求メッセージは HttpClient インスタンスによって既に送信されました。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、コンテンツを含む応答全体が読み取られた後に完了します。 動作は、 が明示的に指定されている場合 ResponseContentRead と同じです。
注意
タイムアウトの場合、.NET 実装ごとに異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでがスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Send(HttpRequestMessage)スローされる例外に関するページを参照してください。
適用対象
.NET