次の方法で共有


HttpClient.GetByteArrayAsync メソッド

定義

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

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

例外

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

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

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

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

注釈

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

注意

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

適用対象

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[]>

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

例外

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

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

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

注釈

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

注意

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

適用対象

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[]>

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

例外

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

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

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

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

注釈

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

注意

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

適用対象

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[]>

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

例外

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

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

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

注釈

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

注意

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

適用対象