HttpClient.SendAsync メソッド

定義

名前空間:

System.Net.Http

アセンブリ:

System.Net.Http.dll

アセンブリ:

netstandard.dll

非同期操作として 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 エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。

TaskCanceledException

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

注釈

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

注意

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

• HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
• TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでスローされます。
• TaskCanceledExceptionTimeoutExceptionは、.NET 5 以降のバージョンでスローされます。

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

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

TaskCanceledException

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

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、コンテンツを含む応答全体が読み取られた後に完了します。

注意

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

• HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
• TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでスローされます。
• TaskCanceledExceptionTimeoutExceptionは、.NET 5 以降のバージョンでスローされます。

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

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

TaskCanceledException

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

注釈

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

注意

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

• HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
• TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでスローされます。
• TaskCanceledExceptionTimeoutExceptionは、.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

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

TaskCanceledException

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

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、コンテンツを含む応答全体が読み取られた後に完了します。

注意

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

• HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
• TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでスローされます。
• TaskCanceledExceptionTimeoutExceptionは、.NET 5 以降のバージョンでスローされます。