HttpClient.GetByteArrayAsync Yöntem

Tanım

Ad Alanı:

System.Net.Http

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Http.dll

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini bayt dizisi olarak döndürün.

Aşırı Yüklemeler

Name	Description
GetByteArrayAsync(String)	Belirtilen URI'ye bir GET isteği gönderir ve zaman uyumsuz bir işlemde yanıt gövdesini bayt dizisi olarak döndürür.
GetByteArrayAsync(Uri)	Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini bayt dizisi olarak döndürün.
GetByteArrayAsync(String, CancellationToken)	Belirtilen URI'ye bir GET isteği gönderir ve zaman uyumsuz bir işlemde yanıt gövdesini bayt dizisi olarak döndürür.
GetByteArrayAsync(Uri, CancellationToken)	Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini bayt dizisi olarak döndürün.

Açıklamalar

İşlem engellenmez.

GetByteArrayAsync(String)

Kaynak:

HttpClient.cs

Belirtilen URI'ye bir GET isteği gönderir ve zaman uyumsuz bir işlemde yanıt gövdesini bayt dizisi olarak döndürür.

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

Parametreler

requestUri

String

İsteğin gönderildiği URI.

Döndürülenler

Task<Byte[]>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

InvalidOperationException

requestUri mutlak bir URI değildir ve BaseAddress ayarlanmaz.

HttpRequestException

İstek, ağ bağlantısı hatası, DNS hatası, sunucu sertifikası doğrulama hatası veya geçersiz sunucu yanıtı gibi geçerli bir HTTP yanıtı alma sorunu nedeniyle başarısız oldu. .NET 8 ve sonraki sürümlerde nedeni HttpRequestError

-veya-

Yanıt durum kodu 200-299 aralığının dışındaydı (bu, standarda göre başarıyı gösterir).

-veya-

Yalnızca .NET Framework: İstek zaman aşımına uğradı.

OperationCanceledException

.NET Core ve .NET 5 ve üzeri: İstek zaman aşımı nedeniyle başarısız oldu.

UriFormatException

Sağlanan istek URI'si geçerli göreli veya mutlak URI değil.

Açıklamalar

Bu işlem engellemez. Döndürülen Task<TResult> nesne, yanıt gövdesinin tamamı okunduktan sonra tamamlanır. Dahili olarak, bu işlem yanıt durum kodunun başarı aralığında (200-299) olduğundan emin olmak için kullanır HttpResponseMessage.EnsureSuccessStatusCode ve değilse bir HttpRequestException oluşturur. Bazı senaryolarda, hangi durum kodlarının başarılı olarak kabul edileceği üzerinde daha fazla denetime ihtiyacınız olabilir; örneğin, bir API'nin her zaman döndürmesi 200 OKbeklenebilir. Bu gibi durumlarda, beklenen değerle eşleşip eşleşmediğini StatusCode el ile denetlemenizi öneririz.

Note

Zaman aşımı durumunda, farklı .NET uygulamalarında farklı özel durumlar oluşturulur.

• HttpRequestException tüm geçerli .NET Framework sürümlerinde oluşturulur.
• OperationCanceledException herhangi bir iç özel durum olmadan tüm geçerli .NET Core sürümlerinde oluşturulur.
• OperationCanceledException iç içe yerleştiren TimeoutException .NET 5 ve sonraki sürümlerde oluşturulur.

GetByteArrayAsync(Uri)

Kaynak:

HttpClient.cs

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini bayt dizisi olarak döndürün.

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

Parametreler

requestUri

Uri

İsteğin gönderildiği URI.

Döndürülenler

Task<Byte[]>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

InvalidOperationException

requestUri mutlak bir URI değildir ve BaseAddress ayarlanmaz.

HttpRequestException

İstek, ağ bağlantısı hatası, DNS hatası, sunucu sertifikası doğrulama hatası veya geçersiz sunucu yanıtı gibi geçerli bir HTTP yanıtı alma sorunu nedeniyle başarısız oldu. .NET 8 ve sonraki sürümlerde, nedeni HttpRequestError ile belirtilir.

-veya-

Yanıt durum kodu 200-299 aralığının dışındaydı (bu, standarda göre başarıyı gösterir).

-veya-

Yalnızca .NET Framework: İstek zaman aşımına uğradı.

OperationCanceledException

.NET Core ve .NET 5 ve üzeri: İstek zaman aşımı nedeniyle başarısız oldu.

Açıklamalar

Bu işlem engellemez. Döndürülen Task<TResult> nesne, yanıt gövdesinin tamamı okunduktan sonra tamamlanır. Dahili olarak, bu işlem yanıt durum kodunun başarı aralığında (200-299) olduğundan emin olmak için kullanır HttpResponseMessage.EnsureSuccessStatusCode ve değilse bir HttpRequestException oluşturur. Bazı senaryolarda, hangi durum kodlarının başarılı olarak kabul edileceği üzerinde daha fazla denetime ihtiyacınız olabilir; örneğin, bir API'nin her zaman döndürmesi 200 OKbeklenebilir. Bu gibi durumlarda, beklenen değerle eşleşip eşleşmediğini StatusCode el ile denetlemenizi öneririz.

Note

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestException oluşturur.
• .NET Core herhangi bir iç özel durum olmadan bir OperationCanceledException oluşturur.
• .NET 5 ve üzeri sürümler, bir OperationCanceledException iç içe yerleştiren bir TimeoutException oluşturur.

GetByteArrayAsync(String, CancellationToken)

Kaynak:

HttpClient.cs

Belirtilen URI'ye bir GET isteği gönderir ve zaman uyumsuz bir işlemde yanıt gövdesini bayt dizisi olarak döndürür.

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

Parametreler

requestUri

String

İsteğin gönderildiği URI.

cancellationToken

CancellationToken

İşlemi iptal etmek için iptal belirteci.

Döndürülenler

Task<Byte[]>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

HttpRequestException

İstek, ağ bağlantısı hatası, DNS hatası, sunucu sertifikası doğrulama hatası veya geçersiz sunucu yanıtı gibi geçerli bir HTTP yanıtı alma sorunu nedeniyle başarısız oldu. .NET 8 ve sonraki sürümlerde nedeni HttpRequestError

-veya-

Yanıt durum kodu 200-299 aralığının dışındaydı (bu, standarda göre başarıyı gösterir).

UriFormatException

Sağlanan istek URI'si geçerli göreli veya mutlak URI değil.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

-veya-

.NET Core ve .NET 5 ve üzeri: İstek zaman aşımı nedeniyle başarısız oldu.

Açıklamalar

Bu işlem engellemez. Döndürülen Task<TResult> nesne, yanıt gövdesinin tamamı okunduktan sonra tamamlanır. Dahili olarak, bu işlem yanıt durum kodunun başarı aralığında (200-299) olduğundan emin olmak için kullanır HttpResponseMessage.EnsureSuccessStatusCode ve değilse bir HttpRequestException oluşturur. Bazı senaryolarda, hangi durum kodlarının başarılı olarak kabul edileceği üzerinde daha fazla denetime ihtiyacınız olabilir; örneğin, bir API'nin her zaman döndürmesi 200 OKbeklenebilir. Bu gibi durumlarda, beklenen değerle eşleşip eşleşmediğini StatusCode el ile denetlemenizi öneririz.

Note

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestException oluşturur.
• .NET Core herhangi bir iç özel durum olmadan bir OperationCanceledException oluşturur.
• .NET 5 ve üzeri sürümler, bir OperationCanceledException iç içe yerleştiren bir TimeoutException oluşturur.

GetByteArrayAsync(Uri, CancellationToken)

Kaynak:

HttpClient.cs

Belirtilen URI'ye bir GET isteği gönderin ve zaman uyumsuz bir işlemde yanıt gövdesini bayt dizisi olarak döndürün.

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

Parametreler

requestUri

Uri

İsteğin gönderildiği URI.

cancellationToken

CancellationToken

İşlemi iptal etmek için iptal belirteci.

Döndürülenler

Task<Byte[]>

Zaman uyumsuz işlemi temsil eden görev nesnesi.

Özel durumlar

HttpRequestException

İstek, ağ bağlantısı hatası, DNS hatası, sunucu sertifikası doğrulama hatası veya geçersiz sunucu yanıtı gibi geçerli bir HTTP yanıtı alma sorunu nedeniyle başarısız oldu. .NET 8 ve sonraki sürümlerde nedeni HttpRequestError

-veya-

Yanıt durum kodu 200-299 aralığının dışındaydı (bu, standarda göre başarıyı gösterir).

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

-veya-

.NET Core ve .NET 5 ve üzeri: İstek zaman aşımı nedeniyle başarısız oldu.

Açıklamalar

Bu işlem engellemez. Döndürülen Task<TResult> nesne, yanıt gövdesinin tamamı okunduktan sonra tamamlanır. Dahili olarak, bu işlem yanıt durum kodunun başarı aralığında (200-299) olduğundan emin olmak için kullanır HttpResponseMessage.EnsureSuccessStatusCode ve değilse bir HttpRequestException oluşturur. Bazı senaryolarda, hangi durum kodlarının başarılı olarak kabul edileceği üzerinde daha fazla denetime ihtiyacınız olabilir; örneğin, bir API'nin her zaman döndürmesi 200 OKbeklenebilir. Bu gibi durumlarda, beklenen değerle eşleşip eşleşmediğini StatusCode el ile denetlemenizi öneririz.

Note

Zaman aşımı durumunda:

• .NET Framework bir HttpRequestException oluşturur.
• .NET Core herhangi bir iç özel durum olmadan bir OperationCanceledException oluşturur.
• .NET 5 ve üzeri sürümler, bir OperationCanceledException iç içe yerleştiren bir TimeoutException oluşturur.