HttpClient.GetByteArrayAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestawy:

netstandard.dll, System.Net.Http.dll

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

Przeciążenia

Nazwa	Opis
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 GET 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 GET do określonego identyfikatora URI i zwróć treść odpowiedzi jako tablicę bajtów w operacji asynchronicznej.

Uwagi

Operacja nie zostanie zablokowana.

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

Identyfikator URI, do którego jest wysyłane żądanie.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

InvalidOperationException

Nie requestUri jest to bezwzględny identyfikator URI i BaseAddress nie jest ustawiony.

HttpRequestException

Żądanie nie powiodło się z powodu problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError

— lub —

Kod stanu odpowiedzi znajdował się poza zakresem od 200 do 299 (co wskazuje powodzenie zgodnie ze standardem).

— lub —

tylko .NET Framework: upłynął limit czasu żądania.

OperationCanceledException

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

UriFormatException

Podany identyfikator URI żądania jest nieprawidłowy względny lub bezwzględny identyfikator URI.

Uwagi

Ta operacja nie blokuje. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej treści odpowiedzi. Wewnętrznie ta operacja używa HttpResponseMessage.EnsureSuccessStatusCode metody , aby upewnić się, że kod stanu odpowiedzi znajduje się w zakresie powodzenia (200–299) i zgłasza wartość , HttpRequestException jeśli tak nie jest. W niektórych scenariuszach może być potrzebna większa kontrola nad tym, które kody stanu są uznawane za pomyślne; na przykład interfejs API może zawsze zwracać wartość 200 OK. W takich przypadkach zalecamy ręczne sprawdzenie, czy StatusCode jest zgodna z oczekiwaną wartością.

Note

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

• HttpRequestException jest zgłaszany we wszystkich odpowiednich wersjach programu .NET Framework.
• OperationCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany we wszystkich odpowiednich wersjach .NET Core.
• OperationCanceledException, który zagnieżdża TimeoutException jest zgłaszany w .NET 5 lub nowszych wersjach.

GetByteArrayAsync(Uri)

Źródło:

HttpClient.cs

Wyślij żądanie GET 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

Identyfikator URI, do którego jest wysyłane żądanie.

Zwraca

Task<Byte[]>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

InvalidOperationException

Nie requestUri jest to bezwzględny identyfikator URI i BaseAddress nie jest ustawiony.

HttpRequestException

Żądanie nie powiodło się z powodu problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError.

— lub —

Kod stanu odpowiedzi znajdował się poza zakresem od 200 do 299 (co wskazuje powodzenie zgodnie ze standardem).

— lub —

tylko .NET Framework: upłynął limit czasu żądania.

OperationCanceledException

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

Uwagi

Ta operacja nie blokuje. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej treści odpowiedzi. Wewnętrznie ta operacja używa HttpResponseMessage.EnsureSuccessStatusCode metody , aby upewnić się, że kod stanu odpowiedzi znajduje się w zakresie powodzenia (200–299) i zgłasza wartość , HttpRequestException jeśli tak nie jest. W niektórych scenariuszach może być potrzebna większa kontrola nad tym, które kody stanu są uznawane za pomyślne; na przykład interfejs API może zawsze zwracać wartość 200 OK. W takich przypadkach zalecamy ręczne sprawdzenie, czy StatusCode jest zgodna z oczekiwaną wartością.

Note

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza HttpRequestException.
• .NET Core zgłasza OperationCanceledException bez żadnego wyjątku wewnętrznego.
• .NET 5 lub nowszych wersjach zgłaszają OperationCanceledException, które zagnieżdża 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

Identyfikator URI, do którego jest wysyłane żądanie.

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 problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError

— lub —

Kod stanu odpowiedzi znajdował się poza zakresem od 200 do 299 (co wskazuje powodzenie zgodnie ze standardem).

UriFormatException

Podany identyfikator URI żądania jest nieprawidłowy względny lub bezwzględny identyfikator URI.

OperationCanceledException

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

— lub —

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

Uwagi

Ta operacja nie blokuje. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej treści odpowiedzi. Wewnętrznie ta operacja używa HttpResponseMessage.EnsureSuccessStatusCode metody , aby upewnić się, że kod stanu odpowiedzi znajduje się w zakresie powodzenia (200–299) i zgłasza wartość , HttpRequestException jeśli tak nie jest. W niektórych scenariuszach może być potrzebna większa kontrola nad tym, które kody stanu są uznawane za pomyślne; na przykład interfejs API może zawsze zwracać wartość 200 OK. W takich przypadkach zalecamy ręczne sprawdzenie, czy StatusCode jest zgodna z oczekiwaną wartością.

Note

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza HttpRequestException.
• .NET Core zgłasza OperationCanceledException bez żadnego wyjątku wewnętrznego.
• .NET 5 lub nowszych wersjach zgłaszają OperationCanceledException, które zagnieżdża TimeoutException.

GetByteArrayAsync(Uri, CancellationToken)

Źródło:

HttpClient.cs

Wyślij żądanie GET 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

Identyfikator URI, do którego jest wysyłane żądanie.

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 problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError

— lub —

Kod stanu odpowiedzi znajdował się poza zakresem od 200 do 299 (co wskazuje powodzenie zgodnie ze standardem).

OperationCanceledException

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

— lub —

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

Uwagi

Ta operacja nie blokuje. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej treści odpowiedzi. Wewnętrznie ta operacja używa HttpResponseMessage.EnsureSuccessStatusCode metody , aby upewnić się, że kod stanu odpowiedzi znajduje się w zakresie powodzenia (200–299) i zgłasza wartość , HttpRequestException jeśli tak nie jest. W niektórych scenariuszach może być potrzebna większa kontrola nad tym, które kody stanu są uznawane za pomyślne; na przykład interfejs API może zawsze zwracać wartość 200 OK. W takich przypadkach zalecamy ręczne sprawdzenie, czy StatusCode jest zgodna z oczekiwaną wartością.

Note

W przypadku przekroczenia limitu czasu:

• .NET Framework zgłasza HttpRequestException.
• .NET Core zgłasza OperationCanceledException bez żadnego wyjątku wewnętrznego.
• .NET 5 lub nowszych wersjach zgłaszają OperationCanceledException, które zagnieżdża TimeoutException.