HttpClient.GetByteArrayAsync メソッド

リファレンス

定義

名前空間:: System.Net.Http

アセンブリ:: System.Net.Http.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。

オーバーロード

GetByteArrayAsync(String)	指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。
GetByteArrayAsync(Uri)	指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。
GetByteArrayAsync(String, CancellationToken)	指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。
GetByteArrayAsync(Uri, CancellationToken)	指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。

注釈

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

GetByteArrayAsync(String)

ソース:: HttpClient.cs

ソース:: HttpClient.cs

ソース:: HttpClient.cs

指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string requestUri);

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri);

member this.GetByteArrayAsync : string -> System.Threading.Tasks.Task<byte[]>

Public Function GetByteArrayAsync (requestUri As String) As Task(Of Byte())

パラメーター

requestUri: String

要求の送信先 URI。

戻り値

Task<Byte[]>

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

例外

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

UriFormatException

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

注釈

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

注意

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

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

適用対象

GetByteArrayAsync(Uri)

ソース:: HttpClient.cs

ソース:: HttpClient.cs

ソース:: HttpClient.cs

指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri requestUri);

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri);

member this.GetByteArrayAsync : Uri -> System.Threading.Tasks.Task<byte[]>

Public Function GetByteArrayAsync (requestUri As Uri) As Task(Of Byte())

パラメーター

requestUri: Uri

要求の送信先 URI。

戻り値

Task<Byte[]>

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

例外

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

注釈

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

注意

タイムアウトが発生した場合:

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

適用対象

GetByteArrayAsync(String, CancellationToken)

ソース:: HttpClient.cs

ソース:: HttpClient.cs

ソース:: HttpClient.cs

指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetByteArrayAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>

Public Function GetByteArrayAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of Byte())

パラメーター

requestUri: String

要求の送信先 URI。

cancellationToken: CancellationToken

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

戻り値

Task<Byte[]>

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

例外

HttpRequestException

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

TaskCanceledException

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

UriFormatException

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

OperationCanceledException

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

注釈

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

注意

タイムアウトが発生した場合:

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

適用対象

GetByteArrayAsync(Uri, CancellationToken)

ソース:: HttpClient.cs

ソース:: HttpClient.cs

ソース:: HttpClient.cs

指定 URI に GET 要求を送信し、非同期操作で応答本体をバイト配列として返します。

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ GetByteArrayAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<byte[]> GetByteArrayAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetByteArrayAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>

Public Function GetByteArrayAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of Byte())

パラメーター

requestUri: Uri

要求の送信先 URI。

cancellationToken: CancellationToken

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

戻り値

Task<Byte[]>

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

例外

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

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

注釈

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

注意

タイムアウトが発生した場合:

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

適用対象

次の方法で共有

HttpClient.GetByteArrayAsync メソッド

定義

オーバーロード

注釈

GetByteArrayAsync(String)

パラメーター

戻り値

例外

注釈

適用対象

GetByteArrayAsync(Uri)

パラメーター

戻り値

例外

注釈

適用対象

GetByteArrayAsync(String, CancellationToken)

パラメーター

戻り値

例外

注釈

適用対象

GetByteArrayAsync(Uri, CancellationToken)

パラメーター

戻り値

例外

注釈

適用対象

その他のリソース