HttpClient.GetByteArrayAsync Metoda

Reference

Definice

Obor názvů:: System.Net.Http

Sestavení:: System.Net.Http.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako pole bajtů v asynchronní operaci.

Přetížení

GetByteArrayAsync(String)	Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako pole bajtů v asynchronní operaci.
GetByteArrayAsync(Uri)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako pole bajtů v asynchronní operaci.
GetByteArrayAsync(String, CancellationToken)	Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako pole bajtů v asynchronní operaci.
GetByteArrayAsync(Uri, CancellationToken)	Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako pole bajtů v asynchronní operaci.

Poznámky

Operace nebude blokována.

GetByteArrayAsync(String)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako pole bajtů v asynchronní operaci.

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

Identifikátor URI, na který se požadavek odešle.

Návraty

Task<Byte[]>

Objekt úlohy představující asynchronní operaci.

Výjimky

InvalidOperationException

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

HttpRequestException

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.

TaskCanceledException

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

UriFormatException

Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celého textu odpovědi.

Poznámka

V případě vypršení časového limitu se u různých implementací .NET vyvolá různé výjimky.

HttpRequestException je vyvolán ve všech použitelných verzích rozhraní .NET Framework.
TaskCanceledException ve všech příslušných verzích .NET Core se nevyvolá žádná vnitřní výjimka.
TaskCanceledException vnořování TimeoutException je vyvoláno v .NET 5 a novějších verzích.

Platí pro

GetByteArrayAsync(Uri)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako pole bajtů v asynchronní operaci.

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

Identifikátor URI, na který se požadavek odešle.

Návraty

Task<Byte[]>

Objekt úlohy představující asynchronní operaci.

Výjimky

InvalidOperationException

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

HttpRequestException

Žádost selhala kvůli základnímu problému, jako je například připojení k síti, selhání DNS, ověření certifikátu serveru (nebo vypršení časového limitu pouze pro rozhraní .NET Framework).

TaskCanceledException

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celého textu odpovědi.

Poznámka

V případě vypršení časového limitu:

Rozhraní .NET Framework vyvolá .HttpRequestException
.NET Core vyvolá TaskCanceledException výjimku bez vnitřní výjimky.
.NET 5 a novější verze vyvolají objekt , TaskCanceledException který vnořuje TimeoutException.

Platí pro

GetByteArrayAsync(String, CancellationToken)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

Odešle požadavek GET na zadaný identifikátor URI a vrátí tělo odpovědi jako pole bajtů v asynchronní operaci.

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

Identifikátor URI, na který se požadavek odešle.

cancellationToken: CancellationToken

Token zrušení pro zrušení operace.

Návraty

Task<Byte[]>

Objekt úlohy představující asynchronní operaci.

Výjimky

HttpRequestException

TaskCanceledException

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

UriFormatException

Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celého textu odpovědi.

Poznámka

V případě vypršení časového limitu:

Rozhraní .NET Framework vyvolá .HttpRequestException
.NET Core vyvolá TaskCanceledException výjimku bez vnitřní výjimky.
.NET 5 a novější verze vyvolají objekt , TaskCanceledException který vnořuje TimeoutException.

Platí pro

GetByteArrayAsync(Uri, CancellationToken)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

Odešlete požadavek GET na zadaný identifikátor URI a vraťte tělo odpovědi jako pole bajtů v asynchronní operaci.

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

Identifikátor URI, na který se požadavek odešle.

cancellationToken: CancellationToken

Token zrušení pro zrušení operace.

Návraty

Task<Byte[]>

Objekt úlohy představující asynchronní operaci.

Výjimky

HttpRequestException

TaskCanceledException

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celého textu odpovědi.

Poznámka

V případě vypršení časového limitu:

Rozhraní .NET Framework vyvolá .HttpRequestException
.NET Core vyvolá TaskCanceledException výjimku bez vnitřní výjimky.
.NET 5 a novější verze vyvolají objekt , TaskCanceledException který vnořuje TimeoutException.

Platí pro

Sdílet prostřednictvím

HttpClient.GetByteArrayAsync Metoda

Definice

Přetížení

Poznámky

GetByteArrayAsync(String)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

GetByteArrayAsync(Uri)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

GetByteArrayAsync(String, CancellationToken)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

GetByteArrayAsync(Uri, CancellationToken)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Další materiály