HttpClient.GetByteArrayAsync Metoda
Definice
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
Objekt úlohy představující asynchronní operaci.
Výjimky
Musí requestUri
být absolutní identifikátor URI nebo BaseAddress musí být nastaven.
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.
Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.
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
Objekt úlohy představující asynchronní operaci.
Výjimky
Musí requestUri
být absolutní identifikátor URI nebo BaseAddress musí být nastaven.
Žá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).
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
Objekt úlohy představující asynchronní operaci.
Výjimky
Žá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).
Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.
Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.
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
Objekt úlohy představující asynchronní operaci.
Výjimky
Žá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).
Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.
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.