HttpClient.GetByteArrayAsync Méthode

Référence

Définition

Espace de noms:: System.Net.Http

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de tableau d'octets dans une opération asynchrone.

Surcharges

GetByteArrayAsync(String)	Envoie une requête GET à l’URI spécifié et retourne le corps de la réponse sous forme de tableau d’octets dans une opération asynchrone.
GetByteArrayAsync(Uri)	Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de tableau d'octets dans une opération asynchrone.
GetByteArrayAsync(String, CancellationToken)	Envoie une requête GET à l’URI spécifié et retourne le corps de la réponse sous forme de tableau d’octets dans une opération asynchrone.
GetByteArrayAsync(Uri, CancellationToken)	Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de tableau d'octets dans une opération asynchrone.

Remarques

L’opération ne se bloque pas.

GetByteArrayAsync(String)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET à l’URI spécifié et retourne le corps de la réponse sous forme de tableau d’octets dans une opération asynchrone.

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

Paramètres

requestUri: String

URI auquel la requête est envoyée.

Retours

Task<Byte[]>

Objet de tâche représentant l'opération asynchrone.

Exceptions

InvalidOperationException

requestUri doit être un URI absolu ou BaseAddress doit être défini.

HttpRequestException

La demande a échoué en raison d’un problème sous-jacent, comme la connectivité réseau, une défaillance du DNS, la validation du certificat du serveur ou le délai d’attente.

TaskCanceledException

.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison d’un délai d’expiration.

UriFormatException

L’URI de requête fourni n’est pas un URI relatif ou absolu valide.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task<TResult> se termine une fois que l’ensemble du corps de la réponse est lu.

Note

En cas de délai d’expiration, différentes exceptions sont levées sur différentes implémentations .NET.

HttpRequestException est levée sur toutes les versions de .NET Framework applicables.
TaskCanceledException sans aucune exception interne est levée sur toutes les versions de .NET Core applicables.
TaskCanceledException qui imbrit un TimeoutException est levée sur .NET 5 et versions ultérieures.

S’applique à

.NET 9 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetByteArrayAsync(Uri)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de tableau d'octets dans une opération asynchrone.

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

Paramètres

requestUri: Uri

URI auquel la requête est envoyée.

Retours

Task<Byte[]>

Objet de tâche représentant l'opération asynchrone.

Exceptions

InvalidOperationException

requestUri doit être un URI absolu ou BaseAddress doit être défini.

HttpRequestException

La requête a échoué en raison d’un problème sous-jacent, comme la connectivité réseau, une défaillance du DNS, la validation du certificat de serveur (ou l’expiration du délai pour .NET Framework uniquement).

TaskCanceledException

.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison d’un délai d’expiration.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task<TResult> se termine une fois que l’ensemble du corps de la réponse est lu.

Note

En cas de délai d’expiration :

.NET Framework lève un HttpRequestException.
.NET Core lève un TaskCanceledException sans exception interne.
.NET 5 et versions ultérieures lèvent un TaskCanceledException qui imbrique un TimeoutException.

S’applique à

.NET 9 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

GetByteArrayAsync(String, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET à l’URI spécifié et retourne le corps de la réponse sous forme de tableau d’octets dans une opération asynchrone.

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

Paramètres

requestUri: String

URI auquel la requête est envoyée.

cancellationToken: CancellationToken

Jeton d’annulation pour annuler l’opération.

Retours

Task<Byte[]>

Objet de tâche représentant l'opération asynchrone.

Exceptions

HttpRequestException

TaskCanceledException

.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison d’un délai d’expiration.

UriFormatException

L’URI de requête fourni n’est pas un URI relatif ou absolu valide.

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task<TResult> se termine une fois que l’ensemble du corps de la réponse est lu.

Note

En cas de délai d’expiration :

.NET Framework lève un HttpRequestException.
.NET Core lève un TaskCanceledException sans exception interne.
.NET 5 et versions ultérieures lèvent un TaskCanceledException qui imbrique un TimeoutException.

S’applique à

.NET 9 et autres versions

Produit	Versions
.NET	5, 6, 7, 8, 9

GetByteArrayAsync(Uri, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de tableau d'octets dans une opération asynchrone.

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

Paramètres

requestUri: Uri

URI auquel la requête est envoyée.

cancellationToken: CancellationToken

Jeton d’annulation pour annuler l’opération.

Retours

Task<Byte[]>

Objet de tâche représentant l'opération asynchrone.

Exceptions

HttpRequestException

TaskCanceledException

.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison d’un délai d’expiration.

OperationCanceledException

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task<TResult> se termine une fois que l’ensemble du corps de la réponse est lu.

Note

En cas de délai d’expiration :

.NET Framework lève un HttpRequestException.
.NET Core lève un TaskCanceledException sans exception interne.
.NET 5 et versions ultérieures lèvent un TaskCanceledException qui imbrique un TimeoutException.

S’applique à

.NET 9 et autres versions

Produit	Versions
.NET	5, 6, 7, 8, 9

Partager via

HttpClient.GetByteArrayAsync Méthode

Définition

Surcharges

Remarques

GetByteArrayAsync(String)

Paramètres

Retours

Exceptions

Remarques

S’applique à

GetByteArrayAsync(Uri)

Paramètres

Retours

Exceptions

Remarques

S’applique à

GetByteArrayAsync(String, CancellationToken)

Paramètres

Retours

Exceptions

Remarques

S’applique à

GetByteArrayAsync(Uri, CancellationToken)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Ressources supplémentaires