Windows.Web.Http Namespace

Klassen

Strukturen

Schnittstellen

Enumerationen

Beispiele

Der folgende Beispielcode zeigt, wie Sie Inhalte von einem HTTP-Server als Zeichenfolge abrufen.

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).

Hinweise

Der Windows.Web.Http-Namespace und die zugehörigen Namespaces "Windows.Web.Http.Headers " und "Windows.Web.Http.Filters " stellen eine Programmierschnittstelle für die UWP-App bereit, die auf HTTP- und REST-Dienste ausgerichtet ist. Diese Features dieser neuen HTTP-API sind so konzipiert, dass sie mit HTTP konform sind, wie in RFC 2616 von der IETF definiert. Die neue HTTP-API bietet konsistente Unterstützung in JavaScript, C#, VB.NET und C++ für Entwickler.

Diese neue API ersetzt die Verwendung von drei verschiedenen APIs durch unterschiedliche Features, die zuvor für jede Sprachprojektion in Windows 8 erforderlich waren.

• WinJS.xhr für JavaScript
• HttpClient im System.Net.Http-Namespace für C# und VB.
• IXMLHTTPRequest2 für C++

Klassen in den Windows.Web.Http- und zugehörigen Namespaces sind auf alle Ebenen der HTTP- und REST-Entwicklung ausgerichtet:

• Grundlegende HTTP-Entwickler
• Websitespezifische HTTP-Bibliotheksentwickler
• Erweiterte HTTP-Entwickler

Für einfache HTTP-Entwickler verfügt die neue API über eine einfache Schnittstelle zum Verarbeiten der gängigsten Aufgaben und sinnvollen Standardwerte für die Authentifizierung, die in den meisten Umgebungen funktionieren sollten. Für Bibliotheksentwickler bedeutet das konsistente Objektmodell und die Unterstützung mehrerer Sprachen, dass Sie eine Bibliothek einmal für Entwickler in allen Sprachen schreiben können. Für fortgeschrittene HTTP-Entwickler enthält die neue API umfangreiche Funktionen.

Der Windows.Web.Http-Namespace und die zugehörigen Namespaces stellen die folgenden Komponenten bereit:

• HttpClient : die Standard-Klasse, die Anforderungen über HTTP sendet und empfängt.
• HttpRequestMessage : HTTP-Anforderungsmeldungen, die in RFC 2616 definiert sind.
• HttpResponseMessage : HTTP-Antwortnachrichten, die in RFC 2616 definiert sind.

Der Inhalt einer HTTP-Nachricht entspricht dem in RFC 2616 definierten Entitätstext. Mehrere Klassen und eine Schnittstelle im Windows.Web.Http-Namespace können für HTTP-Inhalte verwendet werden, einschließlich:

• IHttpContent : Eine Basisschnittstelle für Entwickler, um ihre eigenen Inhaltsobjekte zu erstellen. Es stellt einen HTTP-Entitätstext und Inhaltsheader dar. Diese Schnittstelle verfügt über Methoden, mit denen die tatsächlichen Inhaltsdaten abgerufen und festgelegt werden. Außerdem werden Eigenschaften bereitgestellt, die inhaltsbezogene Header abrufen und festlegen.
• HttpBufferContent : HTTP-Inhalt, der einen Puffer verwendet.
• HttpFormUrlEncodedContent : HTTP-Inhalt, der Name/Wert-Tupel verwendet, die mit dem MIME-Typ application/x-www-form-urlencoded codiert sind.
• HttpMultipartContent : HTTP-Inhalt, der mehrteilige/* MIME-Typ verwendet.
• HttpMultipartFormDataContent : HTTP-Inhalt, der den codierten MIME-Typ multipart/form-data verwendet.
• HttpStreamContent : HTTP-Inhalt, der einen Stream verwendet. Dieser Inhaltstyp wird von der HTTP GET-Methode zum Empfangen von Daten und der HTTP POST-Methode zum Hochladen von Daten verwendet.
• HttpStringContent : HTTP-Inhalt, der eine Zeichenfolge verwendet.

Klassen im Windows.Web.Http.Headers-Namespace stellen HTTP-Header dar, die in RFC 2616 definiert sind. HTTP-Header sind HttpRequestMessage und HttpResponseMessage als Eigenschaften zugeordnet, die abgerufen oder festgelegt werden.

Klassen im Windows.Web.Http-Namespace können Filter basierend auf den Klassen im Windows.Web.Http.Filters-Namespace verwenden. Filter stellen Handler bereit, um bei häufigen HTTP-Dienstproblemen zu helfen. Filter können in einer Sequenz miteinander verkettet werden, um komplexere HTTP-Dienstprobleme zu beheben. Mehrere sofort einsatzbereite Filter sind in Windows 8.1 enthalten, um Bibliotheksentwicklern bei der Behebung allgemeiner HTTP-Dienstprobleme zu helfen. Diese Filter umfassen Handler für überwachte Netzwerkverbindungen und wiederholen sie. Bibliotheksentwickler können eigene Filter für standortspezifische Probleme schreiben (beispielsweise kann eine Website die Antwort 503 (Server nicht verfügbar) verwenden, um anzugeben, dass die Anforderung wiederholt werden soll.

Wenn eine App, die den Windows.Web.Http-Namespace und die zugehörigen Namespaces Windows.Web.Http.Headers und Windows.Web.Http.Filters verwendet, große Datenmengen (mindestens 50 Megabyte) herunterlädt, sollte die App diese Downloads streamen und nicht den Standardpuffer verwenden. Wenn der Standardpuffer verwendet wird, wird die Arbeitsspeicherauslastung des Clients sehr groß, was zu einer Leistungsminderung führen kann.

Beispielcode in C#/VB/C++ und XAML, der zeigt, wie HttpClient zum Herstellen einer Verbindung mit einem HTTP-Server verwendet wird, finden Sie unter HttpClient.

Beispielcode in JavaScript und HTML, der zeigt, wie HttpClient zum Herstellen einer Verbindung mit einem HTTP-Server verwendet wird, finden Sie unter Herstellen einer Verbindung mit einem HTTP-Server mithilfe von Windows.Web.Http.