Windows.Web.Http 命名空间

类

结构

接口

枚举

示例

下面的示例代码演示如何以字符串的形式从 HTTP 服务器获取内容。

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

注解

Windows.Web.Http 命名空间以及相关的 Windows.Web.Http.Headers 和 Windows.Web.Http.Filters 命名空间为面向 HTTP 和 REST 服务的 UWP 应用提供编程接口。 此新 HTTP API 的此功能设计为符合 IETF RFC 2616 中定义的 HTTP。 新的 HTTP API 为开发人员提供 JavaScript、C#、VB.NET 和 C++ 中的一致支持。

此新 API 将三个不同 API 的使用替换为 Windows 8 中每种语言投影之前所需的不同功能。

• 适用于 JavaScript 的 WinJS.xhr
• 适用于 C# 和 VB 的 System.Net.Http 命名空间中的 HttpClient。
• 适用于 C++ 的 IXMLHTTPRequest2

Windows.Web.Http 和相关命名空间中的类面向 HTTP 和 REST 开发的所有级别：

• 基本 HTTP 开发人员
• 特定于站点的 HTTP 库开发人员
• 高级 HTTP 开发人员

对于基本 HTTP 开发人员，新 API 具有一个简单的接口，用于处理最常见的任务和在大多数环境中运行的身份验证的合理默认值。 对于库开发人员来说，一致的对象模型和多种语言支持意味着你可以为所有语言的开发人员编写一次库。 对于高级 HTTP 开发人员，新 API 包括一组丰富的功能。

Windows.Web.Http 命名空间和相关命名空间提供以下组件：

• HttpClient - 通过 HTTP 发送和接收请求的main类。
• HttpRequestMessage - RFC 2616 中定义的 HTTP 请求消息。
• HttpResponseMessage - RFC 2616 中定义的 HTTP 响应消息。

HTTP 消息的内容对应于 RFC 2616 中定义的实体正文。 Windows.Web.Http 命名空间中的多个类和接口可用于 HTTP 内容，包括：

• IHttpContent - 供开发人员创建自己的内容对象的基接口。 它表示 HTTP 实体正文和内容标头。 此接口具有获取和设置实际内容数据的方法。 它还提供用于获取和设置内容相关标头的属性。
• HttpBufferContent - 使用缓冲区的 HTTP 内容。
• HttpFormUrlEncodedContent - HTTP 内容，它使用以 application/x-www-form-urlencoded MIME 类型编码的名称/值元组。
• HttpMultipartContent - 使用 多部分/* MIME 类型的 HTTP 内容。
• HttpMultipartFormDataContent - 使用编码的多 部分/表单数据 MIME 类型的 HTTP 内容。
• HttpStreamContent - 使用流的 HTTP 内容。 此内容类型由 HTTP GET 方法用于接收数据，HTTP POST 方法用于上传数据。
• HttpStringContent - 使用字符串的 HTTP 内容。

Windows.Web.Http.Headers 命名空间中的类表示 RFC 2616 中定义的 HTTP 标头。 HTTP 标头与 HttpRequestMessage 和 HttpResponseMessage 关联为检索或设置的属性。

Windows.Web.Http 命名空间中的类可以使用基于 Windows.Web.Http.Filters 命名空间中的类的筛选器。 筛选器提供处理程序来帮助解决常见的 HTTP 服务问题。 筛选器可以按顺序链接在一起，以解决更复杂的 HTTP 服务问题。 Windows 8.1附带了多个现成的筛选器，可帮助库开发人员解决常见的 HTTP 服务问题。 这些筛选器包括受监视网络连接和重试的处理程序。 库开发人员可以针对特定于站点的问题编写自己的筛选器 (例如，网站可能会使用 503 (服务器不可用) 响应来指示应重试请求) 。

如果使用 Windows.Web.Http 命名空间和相关 Windows.Web.Http.Headers 和 Windows.Web.Http.Filters 命名空间的应用 (50 兆字节或更多) 下载大量数据，则应用应流式传输这些下载内容，而不使用默认缓冲。 如果使用默认缓冲，客户端内存使用量会非常大，这可能会导致性能降低。

有关 C#/VB/C++ 和 XAML 中演示如何使用 HttpClient 连接到 HTTP 服务器的示例代码，请参阅 HttpClient。

有关 JavaScript 和 HTML 中演示如何使用 HttpClient 连接到 HTTP 服务器的示例代码，请参阅 使用 Windows.Web.Http 连接到 HTTP 服务器。