HttpClient.GetAsync Méthode

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.

Envoyez une requête GET à l’URI spécifié en tant qu’opération asynchrone.

Surcharges

Nom	Description
GetAsync(String)	Envoyez une requête GET à l’URI spécifié en tant qu’opération asynchrone.
GetAsync(Uri)	Envoyez une requête GET à l’URI spécifié en tant qu’opération asynchrone.
GetAsync(String, HttpCompletionOption)	Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP en tant qu’opération asynchrone.
GetAsync(String, CancellationToken)	Envoyez une requête GET à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone.
GetAsync(Uri, HttpCompletionOption)	Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP en tant qu’opération asynchrone.
GetAsync(Uri, CancellationToken)	Envoyez une requête GET à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone.
GetAsync(String, HttpCompletionOption, CancellationToken)	Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP et un jeton d’annulation en tant qu’opération asynchrone.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP et un jeton d’annulation en tant qu’opération asynchrone.

Remarques

L’opération ne bloque pas.

GetAsync(String)

Envoyez une requête GET à l’URI spécifié en tant qu’opération asynchrone.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri);

member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)

Paramètres

requestUri: String

URI auquel la requête est envoyée.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

La requête a échoué en raison d’un problème d’obtention d’une réponse HTTP valide, telle que l’échec de connectivité réseau, l’échec DNS, l’erreur de validation du certificat de serveur ou la réponse du serveur non valide. Sur .NET 8 et versions ultérieures, la raison est indiquée par HttpRequestError

-ou-

.NET Framework uniquement : la requête a expiré.

OperationCanceledException

.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.

UriFormatException

L’URI de la demande fourni n’est pas valide par rapport ou PAR URI absolu.

Remarques

Cette opération ne bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière (y compris le contenu) lue. Le comportement est le même que s’il ResponseContentRead a été spécifié explicitement.

Note

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

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

S’applique à

GetAsync(Uri)

Envoyez une requête GET à l’URI spécifié en tant qu’opération asynchrone.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri);

member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)

Paramètres

requestUri: Uri

URI auquel la requête est envoyée.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

-ou-

.NET Framework uniquement : la requête a expiré.

OperationCanceledException

.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.

Remarques

Note

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

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

S’applique à

GetAsync(String, HttpCompletionOption)

Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP en tant qu’opération asynchrone.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption);

member this.GetAsync : string * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Paramètres

requestUri: String

URI auquel la requête est envoyée.

completionOption: HttpCompletionOption

Valeur d’option d’achèvement HTTP qui indique quand l’opération doit être considérée comme terminée.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

La demande a échoué en raison d’un problème sous-jacent tel que la connectivité réseau, l’échec DNS, la validation du certificat de serveur ou le délai d’expiration.

OperationCanceledException

.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.

UriFormatException

L’URI de la demande fourni n’est pas valide par rapport ou PAR URI absolu.

Remarques

Cette opération ne bloque pas. L’objet retourné Task<TResult> est terminé en fonction du paramètre après la completionOption lecture de la partie ou de l’ensemble de la réponse (y compris le contenu).

Note

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

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

S’applique à

GetAsync(String, CancellationToken)

Envoyez une requête GET à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Paramètres

requestUri: String

URI auquel la requête est envoyée.

cancellationToken: CancellationToken

Jeton d’annulation qui peut être utilisé par d’autres objets ou threads pour recevoir une notification d’annulation.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

-ou-

.NET Framework uniquement : la requête a expiré.

UriFormatException

L’URI de la demande fourni n’est pas valide par rapport ou PAR URI absolu.

OperationCanceledException

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

-ou-

.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.

Remarques

Note

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

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

S’applique à

GetAsync(Uri, HttpCompletionOption)

Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP en tant qu’opération asynchrone.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption);

member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)

Paramètres

requestUri: Uri

URI auquel la requête est envoyée.

completionOption: HttpCompletionOption

Valeur d’option d’achèvement HTTP qui indique quand l’opération doit être considérée comme terminée.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

-ou-

.NET Framework uniquement : la requête a expiré.

OperationCanceledException

.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.

Remarques

Note

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

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

S’applique à

GetAsync(Uri, CancellationToken)

Envoyez une requête GET à l’URI spécifié avec un jeton d’annulation en tant qu’opération asynchrone.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Paramètres

requestUri: Uri

URI auquel la requête est envoyée.

cancellationToken: CancellationToken

Jeton d’annulation qui peut être utilisé par d’autres objets ou threads pour recevoir une notification d’annulation.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

La requête a échoué en raison d’un problème lors de l’obtention d’une réponse HTTP telle que la connectivité réseau, l’échec DNS ou la validation du certificat de serveur. Sur .NET 8 et versions ultérieures, la raison est indiquée par HttpRequestError

-ou-

.NET Framework uniquement : la requête a expiré.

OperationCanceledException

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

-ou-

.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.

Remarques

Note

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

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

S’applique à

GetAsync(String, HttpCompletionOption, CancellationToken)

Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP et un jeton d’annulation en tant qu’opération asynchrone.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : string * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Paramètres

requestUri: String

URI auquel la requête est envoyée.

completionOption: HttpCompletionOption

Valeur d’option d’achèvement HTTP qui indique quand l’opération doit être considérée comme terminée.

cancellationToken: CancellationToken

Jeton d’annulation qui peut être utilisé par d’autres objets ou threads pour recevoir une notification d’annulation.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

-ou-

.NET Framework uniquement : la requête a expiré.

UriFormatException

L’URI de la demande fourni n’est pas valide par rapport ou PAR URI absolu.

OperationCanceledException

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

-ou-

.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.

Remarques

Note

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

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

S’applique à

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Envoyez une requête GET à l’URI spécifié avec une option d’achèvement HTTP et un jeton d’annulation en tant qu’opération asynchrone.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

Paramètres

requestUri: Uri

URI auquel la requête est envoyée.

completionOption: HttpCompletionOption

Valeur d’option d’achèvement HTTP qui indique quand l’opération doit être considérée comme terminée.

cancellationToken: CancellationToken

Jeton d’annulation qui peut être utilisé par d’autres objets ou threads pour recevoir une notification d’annulation.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

-ou-

.NET Framework uniquement : la requête a expiré.

OperationCanceledException

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

-ou-

.NET Core et .NET 5 et versions ultérieures uniquement : la requête a échoué en raison du délai d’expiration.

Remarques

Note

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

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

S’applique à

Commentaires

Cette page a-t-elle été utile ?