Partage via

HttpClient.GetAsync Méthode

  • Référence

Définition

Espace de noms:
System.Net.Http
Assembly:
System.Net.Http.dll
Assembly:
netstandard.dll

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.

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

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.

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.

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

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.

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

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.

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

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.

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

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.

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

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.

S’applique à