HttpClient.GetByteArrayAsync Metode

Definisi

Ruang nama:

System.Net.Http

Rakitan:

netstandard.dll, System.Net.Http.dll

Kirim permintaan GET ke URI yang ditentukan dan kembalikan isi respons sebagai array byte dalam operasi asinkron.

Overload

Nama	Deskripsi
GetByteArrayAsync(String)	Mengirim permintaan GET ke URI yang ditentukan dan mengembalikan isi respons sebagai array byte dalam operasi asinkron.
GetByteArrayAsync(Uri)	Kirim permintaan GET ke URI yang ditentukan dan kembalikan isi respons sebagai array byte dalam operasi asinkron.
GetByteArrayAsync(String, CancellationToken)	Mengirim permintaan GET ke URI yang ditentukan dan mengembalikan isi respons sebagai array byte dalam operasi asinkron.
GetByteArrayAsync(Uri, CancellationToken)	Kirim permintaan GET ke URI yang ditentukan dan kembalikan isi respons sebagai array byte dalam operasi asinkron.

Keterangan

Operasi tidak akan diblokir.

GetByteArrayAsync(String)

Sumber:

HttpClient.cs

Mengirim permintaan GET ke URI yang ditentukan dan mengembalikan isi respons sebagai array byte dalam operasi asinkron.

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

Parameter

requestUri

String

URI tempat permintaan dikirim.

Mengembalikan

Task<Byte[]>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri ini bukan URI absolut dan BaseAddress tidak diatur.

HttpRequestException

Permintaan gagal karena masalah saat mendapatkan respons HTTP yang valid, seperti kegagalan konektivitas jaringan, kegagalan DNS, kesalahan validasi sertifikat server, atau respons server yang tidak valid. Pada .NET 8 dan versi yang lebih baru, alasannya ditunjukkan oleh HttpRequestError

-atau-

Kode status respons berada di luar kisaran 200-299 (yang menunjukkan keberhasilan sesuai standar).

-atau-

.NET Framework saja: Waktu permintaan habis.

OperationCanceledException

.NET Core dan hanya .NET 5 dan yang lebih baru: Permintaan gagal karena waktu habis.

UriFormatException

URI permintaan yang disediakan tidak valid URI relatif atau absolut.

Keterangan

Operasi ini tidak memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh isi respons dibaca. Secara internal, operasi ini menggunakan HttpResponseMessage.EnsureSuccessStatusCode untuk memastikan kode status respons berada dalam rentang keberhasilan (200-299) dan melempar HttpRequestException jika tidak. Dalam beberapa skenario, Anda mungkin memerlukan lebih banyak kontrol atas kode status mana yang dianggap berhasil; misalnya, API mungkin diharapkan untuk selalu mengembalikan 200 OK. Dalam kasus seperti itu, sebaiknya periksa secara manual apakah StatusCode cocok dengan nilai yang diharapkan.

Note

Jika waktu habis, pengecualian yang berbeda dilemparkan pada implementasi .NET yang berbeda.

• HttpRequestException dilemparkan pada semua versi .NET Framework yang berlaku.
• OperationCanceledException tanpa pengecualian dalam dilemparkan pada semua versi .NET Core yang berlaku.
• OperationCanceledException yang menumpuk TimeoutException dilemparkan pada versi .NET 5 dan yang lebih baru.

GetByteArrayAsync(Uri)

Sumber:

HttpClient.cs

Kirim permintaan GET ke URI yang ditentukan dan kembalikan isi respons sebagai array byte dalam operasi asinkron.

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

Parameter

requestUri

Uri

URI tempat permintaan dikirim.

Mengembalikan

Task<Byte[]>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

InvalidOperationException

requestUri ini bukan URI absolut dan BaseAddress tidak diatur.

HttpRequestException

Permintaan gagal karena masalah saat mendapatkan respons HTTP yang valid, seperti kegagalan konektivitas jaringan, kegagalan DNS, kesalahan validasi sertifikat server, atau respons server yang tidak valid. Pada .NET 8 dan versi yang lebih baru, alasannya ditunjukkan oleh HttpRequestError.

-atau-

Kode status respons berada di luar kisaran 200-299 (yang menunjukkan keberhasilan sesuai standar).

-atau-

.NET Framework saja: Waktu permintaan habis.

OperationCanceledException

.NET Core dan hanya .NET 5 dan yang lebih baru: Permintaan gagal karena waktu habis.

Keterangan

Operasi ini tidak memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh isi respons dibaca. Secara internal, operasi ini menggunakan HttpResponseMessage.EnsureSuccessStatusCode untuk memastikan kode status respons berada dalam rentang keberhasilan (200-299) dan melempar HttpRequestException jika tidak. Dalam beberapa skenario, Anda mungkin memerlukan lebih banyak kontrol atas kode status mana yang dianggap berhasil; misalnya, API mungkin diharapkan untuk selalu mengembalikan 200 OK. Dalam kasus seperti itu, sebaiknya periksa secara manual apakah StatusCode cocok dengan nilai yang diharapkan.

Note

Dalam kasus batas waktu:

• .NET Framework melempar > /
• .NET Core melempar OperationCanceledException tanpa pengecualian dalam.
• .NET 5 dan versi yang lebih baru melemparkan OperationCanceledException yang menumpuk TimeoutException.

GetByteArrayAsync(String, CancellationToken)

Sumber:

HttpClient.cs

Mengirim permintaan GET ke URI yang ditentukan dan mengembalikan isi respons sebagai array byte dalam operasi asinkron.

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

Parameter

requestUri

String

URI tempat permintaan dikirim.

cancellationToken

CancellationToken

Token pembatalan untuk membatalkan operasi.

Mengembalikan

Task<Byte[]>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

HttpRequestException

Permintaan gagal karena masalah saat mendapatkan respons HTTP yang valid, seperti kegagalan konektivitas jaringan, kegagalan DNS, kesalahan validasi sertifikat server, atau respons server yang tidak valid. Pada .NET 8 dan versi yang lebih baru, alasannya ditunjukkan oleh HttpRequestError

-atau-

Kode status respons berada di luar kisaran 200-299 (yang menunjukkan keberhasilan sesuai standar).

UriFormatException

URI permintaan yang disediakan tidak valid URI relatif atau absolut.

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

-atau-

.NET Core dan hanya .NET 5 dan yang lebih baru: Permintaan gagal karena waktu habis.

Keterangan

Operasi ini tidak memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh isi respons dibaca. Secara internal, operasi ini menggunakan HttpResponseMessage.EnsureSuccessStatusCode untuk memastikan kode status respons berada dalam rentang keberhasilan (200-299) dan melempar HttpRequestException jika tidak. Dalam beberapa skenario, Anda mungkin memerlukan lebih banyak kontrol atas kode status mana yang dianggap berhasil; misalnya, API mungkin diharapkan untuk selalu mengembalikan 200 OK. Dalam kasus seperti itu, sebaiknya periksa secara manual apakah StatusCode cocok dengan nilai yang diharapkan.

Note

Dalam kasus batas waktu:

• .NET Framework melempar > /
• .NET Core melempar OperationCanceledException tanpa pengecualian dalam.
• .NET 5 dan versi yang lebih baru melemparkan OperationCanceledException yang menumpuk TimeoutException.

GetByteArrayAsync(Uri, CancellationToken)

Sumber:

HttpClient.cs

Kirim permintaan GET ke URI yang ditentukan dan kembalikan isi respons sebagai array byte dalam operasi asinkron.

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

Parameter

requestUri

Uri

URI tempat permintaan dikirim.

cancellationToken

CancellationToken

Token pembatalan untuk membatalkan operasi.

Mengembalikan

Task<Byte[]>

Objek tugas yang mewakili operasi asinkron.

Pengecualian

HttpRequestException

Permintaan gagal karena masalah saat mendapatkan respons HTTP yang valid, seperti kegagalan konektivitas jaringan, kegagalan DNS, kesalahan validasi sertifikat server, atau respons server yang tidak valid. Pada .NET 8 dan versi yang lebih baru, alasannya ditunjukkan oleh HttpRequestError

-atau-

Kode status respons berada di luar kisaran 200-299 (yang menunjukkan keberhasilan sesuai standar).

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

-atau-

.NET Core dan hanya .NET 5 dan yang lebih baru: Permintaan gagal karena waktu habis.

Keterangan

Operasi ini tidak memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah seluruh isi respons dibaca. Secara internal, operasi ini menggunakan HttpResponseMessage.EnsureSuccessStatusCode untuk memastikan kode status respons berada dalam rentang keberhasilan (200-299) dan melempar HttpRequestException jika tidak. Dalam beberapa skenario, Anda mungkin memerlukan lebih banyak kontrol atas kode status mana yang dianggap berhasil; misalnya, API mungkin diharapkan untuk selalu mengembalikan 200 OK. Dalam kasus seperti itu, sebaiknya periksa secara manual apakah StatusCode cocok dengan nilai yang diharapkan.

Note

Dalam kasus batas waktu:

• .NET Framework melempar > /
• .NET Core melempar OperationCanceledException tanpa pengecualian dalam.
• .NET 5 dan versi yang lebih baru melemparkan OperationCanceledException yang menumpuk TimeoutException.