HttpClient.GetByteArrayAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.

Przeciążenia

GetByteArrayAsync(String)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.
GetByteArrayAsync(Uri)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.
GetByteArrayAsync(String, CancellationToken)	Wysyła żądanie GET do określonego identyfikatora URI i zwraca treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.
GetByteArrayAsync(Uri, CancellationToken)	Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.

Uwagi

Operacja nie będzie blokować.

GetByteArrayAsync(String)

Źródło:

HttpClient.cs

Wysyła żądanie GET do określonego identyfikatora URI i zwraca treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.

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

Parametry

requestUri

String

Wysłano identyfikator Uri żądania.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

InvalidOperationException

Musi requestUri być bezwzględnym identyfikatorem URI lub BaseAddress musi być ustawiony.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

UriFormatException

Podany identyfikator URI żądania nie jest prawidłowym względnym lub bezwzględnym identyfikatorem URI.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach platformy .NET.

• HttpRequestExceptionjest zgłaszany we wszystkich odpowiednich wersjach .NET Framework.
• TaskCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany we wszystkich odpowiednich wersjach platformy .NET Core.
• TaskCanceledException zagnieżdża TimeoutException element , który jest zgłaszany na platformie .NET 5 i nowszych wersjach.

GetByteArrayAsync(Uri)

Źródło:

HttpClient.cs

Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.

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

Parametry

requestUri

Uri

Wysłano identyfikator Uri żądania.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

InvalidOperationException

Musi requestUri być bezwzględnym identyfikatorem URI lub BaseAddress musi być ustawiony.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).

TaskCanceledException

Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.

GetByteArrayAsync(String, CancellationToken)

Źródło:

HttpClient.cs

Wysyła żądanie GET do określonego identyfikatora URI i zwraca treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.

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

Parametry

requestUri

String

Wysłano identyfikator Uri żądania.

cancellationToken

CancellationToken

Token anulowania w celu anulowania operacji.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).

TaskCanceledException

Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

UriFormatException

Podany identyfikator URI żądania nie jest prawidłowym względnym lub bezwzględnym identyfikatorem URI.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.

GetByteArrayAsync(Uri, CancellationToken)

Źródło:

HttpClient.cs

Wyślij żądanie POBIERZ do określonego identyfikatora Uri i zwróć treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.

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

Parametry

requestUri

Uri

Wysłano identyfikator Uri żądania.

cancellationToken

CancellationToken

Token anulowania w celu anulowania operacji.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, weryfikacja certyfikatu serwera (lub przekroczenie limitu czasu tylko dla .NET Framework).

TaskCanceledException

Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej treści odpowiedzi.

Uwaga

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza błąd HttpRequestException.
• Platforma .NET Core zgłasza wyjątek TaskCanceledException wewnętrzny bez wyjątku wewnętrznego.
• Program .NET 5 i nowsze wersje zgłaszają element TaskCanceledException , który zagnieżdża element TimeoutException.