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.Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation.

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.Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation.

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.Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation.

GetStringAsync(String, CancellationToken)
GetStringAsync(Uri, CancellationToken)

Remarques

Cette opération n’est pas bloquée.This operation will not block.

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.Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation.

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.The Uri the request is sent to.

Retours

Task<String>

Objet de tâche représentant l'opération asynchrone.The task object representing the asynchronous operation.

Exceptions

Le requestUri est null.The requestUri is null.

La requête a échoué en raison d’un problème sous-jacent, par exemple un problème de connectivité réseau, un échec de DNS, un problème de validation de certificat de serveur ou l’expiration d’un délai.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.

.NET Core et .NET 5,0 et versions ultérieures uniquement : la demande a échoué en raison du dépassement du délai d’attente..NET Core and .NET 5.0 and later only: The request failed due to timeout.

Remarques

Cette opération n’est pas bloquée.This operation will not block. L' Task<TResult> objet retourné se termine une fois que le corps de la réponse est lu dans son intégralité.The returned Task<TResult> object will complete after the whole response body is read.

Notes

En cas de dépassement du délai d’attente, différentes exceptions sont levées sur différentes implémentations de .NET.In case of timeout, different exceptions are thrown on different .NET implementations.

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.Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation.

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.The Uri the request is sent to.

Retours

Task<String>

Objet de tâche représentant l'opération asynchrone.The task object representing the asynchronous operation.

Exceptions

Le requestUri est null.The requestUri is null.

La requête a échoué en raison d’un problème sous-jacent, par exemple un problème de connectivité réseau, un échec de DNS, un problème de validation de certificat de serveur ou l’expiration d’un délai.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.

.NET Core et .NET 5,0 et versions ultérieures uniquement : la demande a échoué en raison du dépassement du délai d’attente..NET Core and .NET 5.0 and later only: The request failed due to timeout.

Remarques

Cette opération n’est pas bloquée.This operation will not block. L' Task<TResult> objet retourné se termine une fois que le corps de la réponse est lu dans son intégralité.The returned Task<TResult> object will complete after the whole response body is read.

Notes

En cas de dépassement du délai d’attente, différentes exceptions sont levées sur différentes implémentations de .NET.In case of timeout, different exceptions are thrown on different .NET implementations.

GetStringAsync(String, CancellationToken)

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
cancellationToken
CancellationToken

Retours

Task<String>

GetStringAsync(Uri, CancellationToken)

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
cancellationToken
CancellationToken

Retours

Task<String>

S’applique à