HttpClient.GetAsync Méthode

Définition

Espace de noms:

System.Net.Http

Assembly:

System.Net.Http.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

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

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.

GetAsync(Uri)

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

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.

• 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.

GetAsync(String, HttpCompletionOption)

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

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.

GetAsync(String, CancellationToken)

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

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.

• 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.

GetAsync(Uri, HttpCompletionOption)

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

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.

• 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.

GetAsync(Uri, CancellationToken)

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

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.

• 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.

GetAsync(String, HttpCompletionOption, CancellationToken)

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

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.

• 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.

GetAsync(Uri, HttpCompletionOption, CancellationToken)

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

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.

• 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.