HttpClient.SendAsync メソッド

定義

非同期操作として 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

操作をキャンセルするキャンセル トークン。

戻り値

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

例外

requestnull です。

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

ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

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

注釈

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

注意

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

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの 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 要求メッセージ。

戻り値

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

例外

requestnull です。

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

ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

注釈

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

Note

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

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの 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

操作が完了したとき (応答が使用できる状態になった後か、応答コンテンツ全体が読み取られた後)。

戻り値

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

例外

requestnull です。

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

ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

注釈

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

注意

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

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

適用対象

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

操作をキャンセルするキャンセル トークン。

戻り値

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

例外

requestnull です。

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

ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。

.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。

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

注釈

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

Note

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

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

適用対象