HttpClient.GetStringAsync Méthode
Définition
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 à 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
- Source:
- HttpClient.cs
- 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);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
Objet de tâche représentant l'opération asynchrone.
Exceptions
requestUri doit être un URI absolu ou BaseAddress doit être défini.
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).
.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison d’un délai d’expiration.
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.
S’applique à
GetStringAsync(Uri)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- 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);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
Objet de tâche représentant l'opération asynchrone.
Exceptions
requestUri doit être un URI absolu ou BaseAddress doit être défini.
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).
.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.
S’applique à
GetStringAsync(String, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- 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
Objet de tâche représentant l'opération asynchrone.
Exceptions
requestUri a la valeur null.
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).
.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison d’un délai d’expiration.
L’URI de requête fourni n’est pas un URI relatif ou absolu valide.
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.
S’applique à
GetStringAsync(Uri, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- 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
Objet de tâche représentant l'opération asynchrone.
Exceptions
requestUri a la valeur null.
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).
.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison d’un délai d’expiration.
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.
