HttpClient.GetAsync メソッド

定義

名前空間:

System.Net.Http

アセンブリ:

System.Net.Http.dll

指定された URI に GET 要求を非同期操作として送信します。

オーバーロード

GetAsync(String)	指定された URI に GET 要求を非同期操作として送信します。
GetAsync(Uri)	指定された URI に GET 要求を非同期操作として送信します。
GetAsync(String, HttpCompletionOption)	非同期操作としてHTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。
GetAsync(String, CancellationToken)	非同期操作としてキャンセル トークンを使用して GET 要求を指定された Uri に送信します。
GetAsync(Uri, HttpCompletionOption)	非同期操作としてHTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。
GetAsync(Uri, CancellationToken)	非同期操作としてキャンセル トークンを使用して GET 要求を指定された Uri に送信します。
GetAsync(String, HttpCompletionOption, CancellationToken)	非同期操作としてキャンセル トークンおよび HTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。
GetAsync(Uri, HttpCompletionOption, CancellationToken)	非同期操作としてキャンセル トークンおよび HTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。

注釈

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

GetAsync(String)

ソース:

HttpClient.cs

指定された URI に GET 要求を非同期操作として送信します。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri);

member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)

パラメーター

requestUri

String

要求の送信先 URI。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

HttpRequestException

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

TaskCanceledException

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

UriFormatException

指定された要求 URI が有効な相対 URI または絶対 URI ではありません。

注釈

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

注意

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

• HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
• TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
• TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。

GetAsync(Uri)

ソース:

HttpClient.cs

指定された URI に GET 要求を非同期操作として送信します。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri);

member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)

パラメーター

requestUri

Uri

要求の送信先 URI。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

HttpRequestException

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

TaskCanceledException

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

注釈

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

注意

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

• HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
• TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
• TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。

GetAsync(String, HttpCompletionOption)

ソース:

HttpClient.cs

非同期操作としてHTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Net.Http.HttpCompletionOption completionOption);

member this.GetAsync : string * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

パラメーター

requestUri

String

要求の送信先 URI。

completionOption

HttpCompletionOption

操作が完了したものと見なすタイミングを示す HTTP 完了オプション値。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

HttpRequestException

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

TaskCanceledException

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

UriFormatException

指定された要求 URI が有効な相対 URI または絶対 URI ではありません。

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、一部またはすべての応答 (コンテンツを含む) が読み取られた後に completionOption パラメーターに基づいて完了します。

注意

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

• HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
• TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
• TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。

GetAsync(String, CancellationToken)

ソース:

HttpClient.cs

非同期操作としてキャンセル トークンを使用して GET 要求を指定された Uri に送信します。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

パラメーター

requestUri

String

要求の送信先 URI。

cancellationToken

CancellationToken

キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

HttpRequestException

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

TaskCanceledException

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

UriFormatException

指定された要求 URI が有効な相対 URI または絶対 URI ではありません。

OperationCanceledException

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

注釈

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

注意

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

• HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
• TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
• TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。

GetAsync(Uri, HttpCompletionOption)

ソース:

HttpClient.cs

非同期操作としてHTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Net.Http.HttpCompletionOption completionOption);

member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

パラメーター

requestUri

Uri

要求の送信先 URI。

completionOption

HttpCompletionOption

操作が完了したものと見なすタイミングを示す HTTP 完了オプション値。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

HttpRequestException

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

TaskCanceledException

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

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、一部またはすべての応答 (コンテンツを含む) が読み取られた後に completionOption パラメーターに基づいて完了します。

注意

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

• HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
• TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
• TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。

GetAsync(Uri, CancellationToken)

ソース:

HttpClient.cs

非同期操作としてキャンセル トークンを使用して GET 要求を指定された Uri に送信します。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

パラメーター

requestUri

Uri

要求の送信先 URI。

cancellationToken

CancellationToken

キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

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

注釈

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

注意

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

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

GetAsync(String, HttpCompletionOption, CancellationToken)

ソース:

HttpClient.cs

非同期操作としてキャンセル トークンおよび HTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : string * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

パラメーター

requestUri

String

要求の送信先 URI。

completionOption

HttpCompletionOption

操作が完了したものと見なすタイミングを示す HTTP 完了オプション値。

cancellationToken

CancellationToken

キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

HttpRequestException

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

TaskCanceledException

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

UriFormatException

指定された要求 URI が有効な相対 URI または絶対 URI ではありません。

OperationCanceledException

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

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、一部またはすべての応答 (コンテンツを含む) が読み取られた後に completionOption パラメーターに基づいて完了します。

注意

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

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

GetAsync(Uri, HttpCompletionOption, CancellationToken)

ソース:

HttpClient.cs

非同期操作としてキャンセル トークンおよび HTTP 完了オプションを使用して GET 要求を指定された Uri に送信します。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

パラメーター

requestUri

Uri

要求の送信先 URI。

completionOption

HttpCompletionOption

操作が完了したものと見なすタイミングを示す HTTP 完了オプション値。

cancellationToken

CancellationToken

キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。

戻り値

Task<HttpResponseMessage>

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

例外

InvalidOperationException

requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

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

注釈

この操作はブロックされません。 返された Task<TResult> オブジェクトは、一部またはすべての応答 (コンテンツを含む) が読み取られた後に completionOption パラメーターに基づいて完了します。

注意

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

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