HttpClient.GetStringAsync 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 chaîne dans une opération asynchrone.

Surcharges

GetStringAsync(String)	Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de chaîne dans une opération asynchrone.
GetStringAsync(Uri)	Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de chaîne dans une opération asynchrone.
GetStringAsync(String, CancellationToken)	Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de chaîne dans une opération asynchrone.
GetStringAsync(Uri, CancellationToken)	Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de chaîne dans une opération asynchrone.

Remarques

Cette opération ne se bloque pas.

GetStringAsync(String)

Source:

HttpClient.cs

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de chaîne dans une opération asynchrone.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri);

public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri);

member this.GetStringAsync : string -> System.Threading.Tasks.Task<string>

Public Function GetStringAsync (requestUri As String) As Task(Of String)

Paramètres

requestUri

String

URI auquel la requête est envoyée.

Retours

Task<String>

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 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 que l’ensemble du corps de la réponse est lu.

Notes

En cas de délai d’expiration :

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

GetStringAsync(Uri)

Source:

HttpClient.cs

Envoie une requête GET à l'URI spécifié et retourne le corps de la réponse sous forme de chaîne dans une opération asynchrone.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri);

public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri);

member this.GetStringAsync : Uri -> System.Threading.Tasks.Task<string>

Public Function GetStringAsync (requestUri As Uri) As Task(Of String)

Paramètres

requestUri

Uri

URI auquel la requête est envoyée.

Retours

Task<String>

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

Remarques

Cette opération ne se bloque pas. L’objet retourné Task<TResult> se termine une fois que l’ensemble du corps de la réponse est lu.

Notes

En cas de délai d’expiration :

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

GetStringAsync(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 chaîne dans une opération asynchrone.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStringAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

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

Paramètres

requestUri

String

URI auquel la requête est envoyée.

cancellationToken

CancellationToken

Jeton d’annulation pour annuler l’opération.

Retours

Task<String>

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

Exceptions

ArgumentNullException

requestUri a la valeur null.

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 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 que l’ensemble du corps de la réponse est lu.

Notes

En cas de délai d’expiration :

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

GetStringAsync(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 chaîne dans une opération asynchrone.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

member this.GetStringAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>

Public Function GetStringAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of String)

Paramètres

requestUri

Uri

URI auquel la requête est envoyée.

cancellationToken

CancellationToken

Jeton d’annulation pour annuler l’opération.

Retours

Task<String>

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

Exceptions

ArgumentNullException

requestUri a la valeur null.

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 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 que l’ensemble du corps de la réponse est lu.

Notes

En cas de délai d’expiration :

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