HttpClient.GetByteArrayAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
- Źródło:
- HttpClient.cs
- Ź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);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
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Musi requestUri być bezwzględnym identyfikatorem URI lub BaseAddress musi być ustawiony.
Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.
Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
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.
Dotyczy
GetByteArrayAsync(Uri)
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
- Ź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);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
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Musi requestUri być bezwzględnym identyfikatorem URI lub BaseAddress musi być ustawiony.
Żą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).
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.
Dotyczy
GetByteArrayAsync(String, CancellationToken)
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
- Ź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
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Żą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).
Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
Podany identyfikator URI żądania nie jest prawidłowym względnym lub bezwzględnym identyfikatorem URI.
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.
Dotyczy
GetByteArrayAsync(Uri, CancellationToken)
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
- Ź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
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Żą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).
Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
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.
