HttpClient.GetAsync 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 vers l'URI spécifié sous forme d'opération asynchrone.

Surcharges

GetAsync(String)	Envoie une requête GET vers l'URI spécifié sous forme d'opération asynchrone.
GetAsync(Uri)	Envoie une requête GET vers l'URI spécifié sous forme d'opération asynchrone.
GetAsync(String, HttpCompletionOption)	Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP sous forme d'opération asynchrone.
GetAsync(String, CancellationToken)	Envoie une requête GET à l'URI spécifié avec un jeton d'annulation sous forme d'opération asynchrone.
GetAsync(Uri, HttpCompletionOption)	Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP sous forme d'opération asynchrone.
GetAsync(Uri, CancellationToken)	Envoie une requête GET à l'URI spécifié avec un jeton d'annulation sous forme d'opération asynchrone.
GetAsync(String, HttpCompletionOption, CancellationToken)	Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP et un jeton d'annulation sous forme d'opération asynchrone.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP et un jeton d'annulation sous forme d'opération asynchrone.

Remarques

L’opération ne se bloque pas.

GetAsync(String)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET vers l'URI spécifié sous forme d'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);

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

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 la réponse entière (y compris le contenu) lue. Le comportement est le même que si ResponseContentRead avait été spécifié explicitement.

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

S’applique à

GetAsync(Uri)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET vers l'URI spécifié sous forme d'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);

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

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.

Remarques

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

S’applique à

GetAsync(String, HttpCompletionOption)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP sous forme d'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);

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

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 en fonction du completionOption paramètre après la lecture de la partie ou de la totalité de la réponse (y compris le contenu).

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

S’applique à

GetAsync(String, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET à l'URI spécifié avec un jeton d'annulation sous forme d'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);

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 être informés de l'annulation.

Retours

Task<HttpResponseMessage>

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.

OperationCanceledException

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

Remarques

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

S’applique à

GetAsync(Uri, HttpCompletionOption)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP sous forme d'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);

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

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.

Remarques

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

S’applique à

GetAsync(Uri, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET à l'URI spécifié avec un jeton d'annulation sous forme d'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);

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 être informés de l'annulation.

Retours

Task<HttpResponseMessage>

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.

OperationCanceledException

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

Remarques

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

S’applique à

GetAsync(String, HttpCompletionOption, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP et un jeton d'annulation sous forme d'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);

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 être informés de l'annulation.

Retours

Task<HttpResponseMessage>

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.

OperationCanceledException

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

Remarques

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

S’applique à

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

Envoie une requête GET à l'URI spécifié avec une option d'achèvement HTTP et un jeton d'annulation sous forme d'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);

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 être informés de l'annulation.

Retours

Task<HttpResponseMessage>

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.

OperationCanceledException

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

Remarques

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

S’applique à

Partager via

HttpClient.GetAsync Méthode

Définition

Surcharges

Remarques

GetAsync(String)

Paramètres

Retours

Exceptions

Remarques

S’applique à

GetAsync(Uri)

Paramètres

Retours

Exceptions

Remarques

S’applique à

GetAsync(String, HttpCompletionOption)

Paramètres

Retours

Exceptions

Remarques

S’applique à

GetAsync(String, CancellationToken)

Paramètres

Retours

Exceptions

Remarques

S’applique à

GetAsync(Uri, HttpCompletionOption)

Paramètres

Retours

Exceptions

Remarques

S’applique à

GetAsync(Uri, CancellationToken)

Paramètres

Retours

Exceptions

Remarques

S’applique à

GetAsync(String, HttpCompletionOption, CancellationToken)

Paramètres

Retours

Exceptions

Remarques

S’applique à

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Ressources supplémentaires