HttpClient.GetStringAsync(Uri) 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. Pour obtenir des conseils de programmation pour la classe HttpClient et des exemples de code, consultez la rubrique conceptuelle HttpClient .
public:
virtual IAsyncOperationWithProgress<Platform::String ^, HttpProgress> ^ GetStringAsync(Uri ^ uri) = GetStringAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<winrt::hstring, HttpProgress> GetStringAsync(Uri const& uri);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<string,HttpProgress> GetStringAsync(System.Uri uri);function getStringAsync(uri)Public Function GetStringAsync (uri As Uri) As IAsyncOperationWithProgress(Of String, HttpProgress)Paramètres
Retours
IAsyncOperationWithProgress<Platform::String,HttpProgress>
IAsyncOperationWithProgress<winrt::hstring,HttpProgress>
Objet représentant l’opération asynchrone.
- Attributs
Remarques
Cette opération ne se bloque pas. L’IAsyncOperationWithProgress (de string et HttpProgress) retourné se termine une fois que l’ensemble du corps de la réponse est lu.
La classe HttpClient est souvent utilisée par une application pour télécharger, puis analyser du texte. Il est possible que l’encodage de caractères spécifié dans l’en-tête Content-Type par un serveur HTTP ne corresponde pas à l’encodage de caractères du corps de la réponse HTTP (encodage XML dans un document XML, par exemple). Une façon d’utiliser HttpClient avec du texte consiste à appeler la méthode GetStringAsync et à passer la chaîne retournée à l’analyseur de texte. Toutefois, cela peut entraîner des erreurs si content-type n’est pas un type expressible en tant que chaîne. Un moyen fiable d’utiliser HttpClient avec un analyseur XML consiste à appeler la méthode GetBufferAsync et à analyser la mémoire tampon pour l’élément «< ?xml> ». Ensuite, utilisez l’encodage de caractères spécifié (« <xmlversion="1.0 » encoding="UTF-8 »?> », par exemple) pour analyser le corps de la réponse HTTP. Pour d’autres formats de texte, des méthodes similaires peuvent être utilisées lorsque l’application analyse la partie initiale du corps de la réponse HTTP pour déterminer l’encodage de caractères utilisé.
Voici les exceptions levées par cette fonction.
E_INVALIDARG
Le paramètre uri était une référence null (Nothing en Visual Basic).
Gestion des exceptions
Vous devez écrire du code pour gérer les exceptions lorsque vous appelez cette méthode. Les exceptions peuvent résulter d’erreurs de validation de paramètres, d’échecs de résolution de noms et d’erreurs réseau. Des exceptions aux erreurs réseau (perte de connectivité, échecs de connexion et échecs de serveur HTTP, par exemple) peuvent se produire à tout moment. Ces erreurs donnent lieu à la levée d’exceptions. Si elle n’est pas gérée par votre application, une exception peut entraîner l’arrêt de l’ensemble de votre application par le runtime. Pour plus d’informations sur la gestion des exceptions, consultez Gestion des exceptions dans les applications réseau.