HttpClient.SendAsync メソッド

定義

名前空間:: System.Net.Http

アセンブリ:: System.Net.Http.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

HTTP 要求を非同期操作として送信します。

オーバーロード

名前	説明
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)	HTTP 要求を非同期操作として送信します。
SendAsync(HttpRequestMessage)	HTTP 要求を非同期操作として送信します。
SendAsync(HttpRequestMessage, HttpCompletionOption)	HTTP 要求を非同期操作として送信します。
SendAsync(HttpRequestMessage, CancellationToken)	HTTP 要求を非同期操作として送信します。

注釈

この操作はブロックされません。

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

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

取り消し操作の取り消しトークン。

返品

Task<HttpResponseMessage>

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

request は null です。

InvalidOperationException

要求メッセージは、 HttpClient インスタンスによって既に送信されています。

HttpRequestException

ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError

-または-

.NET Framework のみ: 要求がタイムアウトしました。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

-または-

.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。

注釈

この操作はブロックされません。 completionOption パラメーターの値に応じて、返されるTask<TResult> オブジェクトは、応答が使用可能になったり、コンテンツを含む応答全体が読み取られたりするとすぐに完了します。

Note

タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。

HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 Send(HttpRequestMessage, HttpCompletionOption)によってスローされる例外を参照してください。

適用対象

SendAsync(HttpRequestMessage)

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 要求メッセージ。

返品

Task<HttpResponseMessage>

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

request は null です。

InvalidOperationException

要求メッセージは、 HttpClient インスタンスによって既に送信されています。

HttpRequestException

-または-

.NET Framework のみ: 要求がタイムアウトしました。

OperationCanceledException

.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。

注釈

この操作はブロックされません。返された Task<TResult> オブジェクトは、コンテンツを含む応答全体が読み取られた後に完了します。動作は、 ResponseContentRead が明示的に指定されている場合と同じです。

Note

タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。

HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 Send(HttpRequestMessage)によってスローされる例外を参照してください。

適用対象

SendAsync(HttpRequestMessage, HttpCompletionOption)

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

操作が完了する必要がある場合 (応答が利用可能になるとすぐに、または応答の内容全体を読み取った後)。

返品

Task<HttpResponseMessage>

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

request は null です。

InvalidOperationException

要求メッセージは、 HttpClient インスタンスによって既に送信されています。

HttpRequestException

-または-

.NET Framework のみ: 要求がタイムアウトしました。

OperationCanceledException

.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。

注釈

Note

タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。

HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。

適用対象

SendAsync(HttpRequestMessage, CancellationToken)

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

取り消し操作の取り消しトークン。

返品

Task<HttpResponseMessage>

非同期操作を表すタスクオブジェクト。

例外

ArgumentNullException

request は null です。

InvalidOperationException

要求メッセージは、 HttpClient インスタンスによって既に送信されています。

HttpRequestException

-または-

.NET Framework のみ: 要求がタイムアウトしました。

OperationCanceledException

キャンセルトークンが取り消されました。この例外は、返されたタスクに格納されます。

-または-

.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。

注釈

Note

タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。

HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。

このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。格納されている例外については、 Send(HttpRequestMessage)によってスローされる例外を参照してください。

適用対象

フィードバック

このページはお役に立ちましたか?