HttpClient.GetAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
非同期操作として、指定した URI に GET 要求を送信します。
オーバーロード
| 名前 | 説明 |
|---|---|
| GetAsync(String) |
非同期操作として、指定した URI に GET 要求を送信します。 |
| GetAsync(Uri) |
非同期操作として、指定した URI に GET 要求を送信します。 |
| GetAsync(String, HttpCompletionOption) |
HTTP 完了オプションを非同期操作として指定した URI に GET 要求を送信します。 |
| GetAsync(String, CancellationToken) |
非同期操作としてキャンセル トークンを使用して、指定された URI に GET 要求を送信します。 |
| GetAsync(Uri, HttpCompletionOption) |
HTTP 完了オプションを非同期操作として指定した URI に GET 要求を送信します。 |
| GetAsync(Uri, CancellationToken) |
非同期操作としてキャンセル トークンを使用して、指定された URI に GET 要求を送信します。 |
| GetAsync(String, HttpCompletionOption, CancellationToken) |
HTTP 完了オプションとキャンセル トークンを非同期操作として指定した URI に GET 要求を送信します。 |
| GetAsync(Uri, HttpCompletionOption, CancellationToken) |
HTTP 完了オプションとキャンセル トークンを非同期操作として指定した URI に GET 要求を送信します。 |
注釈
この操作はブロックされません。
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);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 エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
指定された要求 URI が有効な相対 URI または絶対 URI ではありません。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。 動作は、 ResponseContentRead が明示的に指定されている場合と同じです。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.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);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 エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。 動作は、 ResponseContentRead が明示的に指定されている場合と同じです。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(String, HttpCompletionOption)
HTTP 完了オプションを非同期操作として指定した URI に GET 要求を送信します。
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 完了オプションの値。
返品
非同期操作を表すタスク オブジェクト。
例外
requestUriは絶対 URI ではなく、BaseAddressは設定されていません。
ネットワーク接続、DNS エラー、サーバー証明書の検証、タイムアウトなどの根本的な問題が原因で要求が失敗しました。
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
指定された要求 URI が有効な相対 URI または絶対 URI ではありません。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答の一部またはすべての (コンテンツを含む) が読み取られた後、 completionOption パラメーターに基づいて完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(String, CancellationToken)
非同期操作としてキャンセル トークンを使用して、指定された URI に GET 要求を送信します。
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
他のオブジェクトまたはスレッドが取り消し通知を受け取るために使用できるキャンセル トークン。
返品
非同期操作を表すタスク オブジェクト。
例外
requestUriは絶対 URI ではなく、BaseAddressは設定されていません。
ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
指定された要求 URI が有効な相対 URI または絶対 URI ではありません。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
-または-
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。 動作は、 ResponseContentRead が明示的に指定されている場合と同じです。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(Uri, HttpCompletionOption)
HTTP 完了オプションを非同期操作として指定した URI に GET 要求を送信します。
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 エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答の一部またはすべての (コンテンツを含む) が読み取られた後、 completionOption パラメーターに基づいて完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(Uri, CancellationToken)
非同期操作としてキャンセル トークンを使用して、指定された URI に GET 要求を送信します。
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 エラー、サーバー証明書の検証などの HTTP 応答を受け取る問題が原因で、要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
-または-
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答全体 (コンテンツを含む) が読み取られた後に完了します。 動作は、 ResponseContentRead が明示的に指定されている場合と同じです。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(String, HttpCompletionOption, CancellationToken)
HTTP 完了オプションとキャンセル トークンを非同期操作として指定した URI に GET 要求を送信します。
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
他のオブジェクトまたはスレッドが取り消し通知を受け取るために使用できるキャンセル トークン。
返品
非同期操作を表すタスク オブジェクト。
例外
requestUriは絶対 URI ではなく、BaseAddressは設定されていません。
ネットワーク接続エラー、DNS エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
指定された要求 URI が有効な相対 URI または絶対 URI ではありません。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
-または-
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答の一部またはすべての (コンテンツを含む) が読み取られた後、 completionOption パラメーターに基づいて完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。
適用対象
GetAsync(Uri, HttpCompletionOption, CancellationToken)
HTTP 完了オプションとキャンセル トークンを非同期操作として指定した URI に GET 要求を送信します。
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 エラー、サーバー証明書検証エラー、無効なサーバー応答など、有効な HTTP 応答の取得に関する問題が原因で要求が失敗しました。 .NET 8 以降のバージョンでは、理由は HttpRequestError
-または-
.NET Framework のみ: 要求がタイムアウトしました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
-または-
.NET Core と .NET 5 以降のみ: タイムアウトのため要求が失敗しました。
注釈
この操作はブロックされません。 返された Task<TResult> オブジェクトは、応答の一部またはすべての (コンテンツを含む) が読み取られた後、 completionOption パラメーターに基づいて完了します。
Note
タイムアウトの場合、異なる.NET実装で異なる例外がスローされます。
- HttpRequestExceptionは、適用可能なすべての .NET Framework バージョンでスローされます。
- 内部例外のない OperationCanceledException は、該当するすべての .NET Core バージョンでスローされます。
- TimeoutExceptionを入れ子にするOperationCanceledExceptionは、.NET 5 以降のバージョンでスローされます。