HttpClient.GetByteArrayAsync メソッド

定義

名前空間:

System.Net.Http

アセンブリ:

System.Net.Http.dll

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

オーバーロード

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

注釈

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

GetByteArrayAsync(String)

ソース:

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);

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

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

public:
 System::Threading::Tasks::Task<cli::array <System::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

指定 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

指定 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にする がスローされます。