HttpClient.GetAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定された 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)
指定された 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);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。
戻り値
非同期操作を表すタスク オブジェクト。
例外
requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
指定された要求 URI が有効な相対 URI または絶対 URI ではありません。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。 動作は、 が明示的に指定されている場合 ResponseContentRead と同じです。
注意
タイムアウトの場合、.NET 実装ごとに異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでがスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(Uri)
指定された 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);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。
戻り値
非同期操作を表すタスク オブジェクト。
例外
requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。 動作は、 が明示的に指定されている場合 ResponseContentRead と同じです。
注意
タイムアウトの場合、.NET 実装ごとに異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでがスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(String, HttpCompletionOption)
非同期操作として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);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 完了オプション値。
戻り値
非同期操作を表すタスク オブジェクト。
例外
requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
指定された要求 URI が有効な相対 URI または絶対 URI ではありません。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、一部またはすべての応答 (コンテンツを含む) が読み取られた後に completionOption パラメーターに基づいて完了します。
注意
タイムアウトの場合、.NET 実装ごとに異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでがスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(String, CancellationToken)
非同期操作としてキャンセル トークンを使用して 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);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
キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。
戻り値
非同期操作を表すタスク オブジェクト。
例外
requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
指定された要求 URI が有効な相対 URI または絶対 URI ではありません。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。 動作は、 が明示的に指定されている場合 ResponseContentRead と同じです。
Note
タイムアウトの場合、.NET 実装ごとに異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでがスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(Uri, HttpCompletionOption)
非同期操作として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);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 完了オプション値。
戻り値
非同期操作を表すタスク オブジェクト。
例外
requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、一部またはすべての応答 (コンテンツを含む) が読み取られた後に completionOption パラメーターに基づいて完了します。
注意
タイムアウトの場合、.NET 実装ごとに異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException 該当するすべての .NET Core バージョンで内部例外なしでがスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(Uri, CancellationToken)
非同期操作としてキャンセル トークンを使用して 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);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
キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。
戻り値
非同期操作を表すタスク オブジェクト。
例外
requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。 動作は、明示的に指定されている場合 ResponseContentRead と同じです。
Note
タイムアウトの場合、異なる .NET 実装で異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(String, HttpCompletionOption, CancellationToken)
非同期操作としてキャンセル トークンおよび 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);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
キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。
戻り値
非同期操作を表すタスク オブジェクト。
例外
requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
指定された要求 URI が有効な相対 URI または絶対 URI ではありません。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、一部またはすべての応答 (コンテンツを含む) が読み取られた後に completionOption パラメーターに基づいて完了します。
注意
タイムアウトの場合、異なる .NET 実装で異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(Uri, HttpCompletionOption, CancellationToken)
非同期操作としてキャンセル トークンおよび 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);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
キャンセル通知を受け取るために他のオブジェクトまたはスレッドで使用できるキャンセル トークン。
戻り値
非同期操作を表すタスク オブジェクト。
例外
requestUri が絶対 URI であるか、BaseAddress が設定されている必要があります。
ネットワーク接続、DNS エラー、サーバー証明書の検証またはタイムアウトなどの基になる問題のため、要求が失敗しました。
.NET Core および .NET 5 以降のみ: タイムアウトが原因で要求が失敗しました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、一部またはすべての応答 (コンテンツを含む) が読み取られた後に completionOption パラメーターに基づいて完了します。
Note
タイムアウトの場合、異なる .NET 実装で異なる例外がスローされます。
- HttpRequestExceptionは、該当するすべての.NET Frameworkバージョンでスローされます。
- TaskCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TaskCanceledException を入れ子 TimeoutException にする は、.NET 5 以降のバージョンでスローされます。
適用対象
.NET
フィードバック
近日公開予定: 2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub イシューを段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、以下を参照してください: https://aka.ms/ContentUserFeedback。
フィードバックの送信と表示