Windows.Web.Http Espace de noms

Classes

Structures

Interfaces

Énumérations

Exemples

L’exemple de code suivant montre comment OBTENIR du contenu à partir d’un serveur HTTP sous forme de chaîne.

using System;
using Windows.Foundation;
using Windows.Web.Http;

// Note: the URI constructor will throw an exception
// if the string passed is not a valid URI
var uri = new Uri("http://example.com/datalist.aspx");
var httpClient = new HttpClient();

// Always catch network exceptions for async methods
try 
{
    var result = await httpClient.GetStringAsync(uri);
}
catch (Exception ex)
{
    // Details in ex.Message and ex.HResult.       
}

// Once your app is done using the HttpClient object call dispose to 
// free up system resources (the underlying socket and memory used for the object)
httpclient.Dispose();

#include "winrt/Windows.Foundation.h"
#include "winrt/Windows.Web.Http.h"
using namespace winrt;

Windows::Foundation::IAsyncAction HttpClientExample()
{
    Windows::Foundation::Uri uri{ L"http://www.bing.com" };
    Windows::Web::Http::HttpClient httpClient{};

    // Always catch network exceptions for async methods.
    try
    {
        auto response{ co_await httpClient.GetStringAsync(uri) };
    }
    catch (winrt::hresult_error const& ex)
    {
        // Details in ex.message() and ex.to_abi().
    }

    // The destructor of HttpClient frees system resources
    // (the underlying socket, and memory used for the object).
}

using namespace Windows::Foundation;
using namespace Windows::Web::Http;

// Note: the URI constructor will throw an exception
// if the string passed is not a valid URI
uri = ref new Uri("http://example.com/datalist.aspx");
httpClient = ref new HttpClient();

// Always catch network exceptions for async methods
try 
{
    httpClient->GetStringAsync(uri);
}
catch (Exception ^ ex) 
{
    // Details in ex.Message and ex.HResult.       
}

// In C++/CX, the system resources used by httpClient object are released 
// when the object falls out of scope or by the destructor (delete operator).

Remarques

L’espace de noms Windows.Web.Http et les espaces de noms Windows.Web.Http.Headers et Windows.Web.Http.Filters associés fournissent une interface de programmation pour l’application UWP qui cible les services HTTP et REST. Ces fonctionnalités de cette nouvelle API HTTP sont conçues pour être conformes à HTTP, comme défini dans la RFC 2616 par l’IETF. La nouvelle API HTTP offre une prise en charge cohérente en JavaScript, C#, VB.NET et C++ pour les développeurs.

Cette nouvelle API remplace l’utilisation de trois API différentes par des fonctionnalités différentes qui étaient auparavant nécessaires pour chaque projection de langage dans Windows 8.

• WinJS.xhr pour JavaScript
• HttpClient dans l’espace de noms System.Net.Http pour C# et VB.
• IXMLHTTPRequest2 pour C++

Les classes dans Windows.Web.Http et les espaces de noms associés sont ciblées à tous les niveaux du développement HTTP et REST :

• Développeurs HTTP de base
• Développeurs de bibliothèque HTTP spécifiques au site
• Développeurs HTTP avancés

Pour les développeurs HTTP de base, la nouvelle API dispose d’une interface simple pour gérer les tâches les plus courantes et les valeurs par défaut raisonnables pour l’authentification qui doivent fonctionner dans la plupart des environnements. Pour les développeurs de bibliothèques, le modèle objet cohérent et la prise en charge de plusieurs langages signifient que vous pouvez écrire une bibliothèque une fois pour les développeurs dans tous les langages. Pour les développeurs HTTP avancés, la nouvelle API inclut un ensemble complet de fonctionnalités.

L’espace de noms Windows.Web.Http et les espaces de noms associés fournissent les composants suivants :

• HttpClient : classe main qui envoie et reçoit des requêtes via HTTP.
• HttpRequestMessage : messages de requête HTTP définis dans RFC 2616.
• HttpResponseMessage : messages de réponse HTTP définis dans RFC 2616.

Le contenu d’un message HTTP correspond au corps d’entité défini dans RFC 2616. Plusieurs classes et une interface de l’espace de noms Windows.Web.Http peuvent être utilisées pour le contenu HTTP, notamment :

• IHttpContent : interface de base permettant aux développeurs de créer leurs propres objets de contenu. Il représente un corps d’entité HTTP et des en-têtes de contenu. Cette interface a des méthodes qui obtiennent et définissent les données de contenu réelles. Il fournit également des propriétés qui obtiennent et définissent des en-têtes liés au contenu.
• HttpBufferContent : contenu HTTP qui utilise une mémoire tampon.
• HttpFormUrlEncodedContent : contenu HTTP qui utilise des tuples nom/valeur encodés avec le type MIME application/x-www-form-urlencoded .
• HttpMultipartContent : contenu HTTP qui utilise le type MIME multipart/*.
• HttpMultipartFormDataContent : contenu HTTP qui utilise le type MIME multipart/form-data encodé.
• HttpStreamContent : contenu HTTP qui utilise un flux. Ce type de contenu est utilisé par la méthode HTTP GET pour recevoir des données et la méthode HTTP POST pour charger des données.
• HttpStringContent : contenu HTTP qui utilise une chaîne.

Les classes de l’espace de noms Windows.Web.Http.Headers représentent des en-têtes HTTP définis dans RFC 2616. Les en-têtes HTTP sont associés à HttpRequestMessage et HttpResponseMessage en tant que propriétés récupérées ou définies.

Les classes de l’espace de noms Windows.Web.Http peuvent utiliser des filtres basés sur les classes de l’espace de noms Windows.Web.Http.Filters . Les filtres fournissent des gestionnaires pour vous aider à résoudre les problèmes courants liés au service HTTP. Les filtres peuvent être chaînés dans une séquence pour résoudre des problèmes de service HTTP plus complexes. Plusieurs filtres prêts à l’emploi sont inclus avec Windows 8.1 pour aider les développeurs de bibliothèques à résoudre les problèmes courants liés au service HTTP. Ces filtres incluent des gestionnaires pour les connexions réseau surveillées et les nouvelles tentatives. Les développeurs de bibliothèque peuvent écrire leurs propres filtres pour les problèmes spécifiques au site (par exemple, un site peut utiliser la réponse 503 (Serveur indisponible) pour indiquer que la demande doit être retentée.

Si une application qui utilise l’espace de noms Windows.Web.Http et les espaces de noms Windows.Web.Http.Headers et Windows.Web.Http.Filters associés télécharge de grandes quantités de données (50 mégaoctets ou plus), l’application doit diffuser ces téléchargements en continu et ne pas utiliser la mise en mémoire tampon par défaut. Si la mise en mémoire tampon par défaut est utilisée, l’utilisation de la mémoire client devient très importante, ce qui peut réduire les performances.

Pour obtenir un exemple de code en C#/VB/C++ et XAML qui montre comment utiliser HttpClient pour se connecter à un serveur HTTP, consultez HttpClient.

Pour obtenir un exemple de code en JavaScript et HTML qui montre comment utiliser HttpClient pour se connecter à un serveur HTTP, consultez Connexion à un serveur HTTP à l’aide de Windows.Web.Http.