Partager via


HttpClient.GetStringAsync Méthode

Définition

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 :

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 :

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 :

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 :

S’applique à