HttpClient.GetByteArrayAsync Méthode

Définition

Espace de noms:

System.Net.Http

Assembly:

System.Net.Http.dll

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

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

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 du 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 le corps de la réponse entier lu.

Notes

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 imbriquez un TimeoutException est levée sur .NET 5 et versions ultérieures.

GetByteArrayAsync(Uri)

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

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 du délai d’expiration.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task<TResult> se termine une fois le corps de la réponse entier lu.

Notes

En cas d’expiration du délai d’attente :

• .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 imbrite un TimeoutException.

GetByteArrayAsync(String, CancellationToken)

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

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 du 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 le corps de la réponse entier lu.

Notes

En cas d’expiration du délai d’attente :

• .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 imbrite un TimeoutException.

GetByteArrayAsync(Uri, CancellationToken)

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

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 du 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 le corps de la réponse entier lu.

Notes

En cas d’expiration du délai d’attente :

• .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 imbrite un TimeoutException.