HttpClient.GetStringAsync(Uri) 方法

  • 参考

定义

命名空间:
Windows.Web.Http
编辑

将 GET 请求发送到指定 URI 并在异步操作中以字符串的形式返回响应正文。 有关 HttpClient 类的编程指南和代码示例，请参阅 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)

参数

uri
Uri Uri

请求发送到的 URI。

返回

IAsyncOperationWithProgress<String,HttpProgress>

IAsyncOperationWithProgress<Platform::String,HttpProgress>

IAsyncOperationWithProgress<winrt::hstring,HttpProgress>

表示异步操作的 对象。

属性
RemoteAsyncAttribute

注解

此操作不会阻止。 读取整个响应正文后，返回的 IAsyncOperationWithProgress (字符串和 HttpProgress) 完成。

应用通常使用 HttpClient 类下载并分析文本。 HTTP 服务器在 Content-Type 标头中指定的字符编码可能与 HTTP 响应正文的字符编码不匹配， (XML 文档中的 XML 编码，例如) 。 对文本使用 HttpClient 的一种方法是调用 GetStringAsync 方法，并将返回的字符串传递给文本分析器。 但是，如果 Content-Type 不是可表示为字符串的类型，则可能会导致错误。 将 HttpClient 与 XML 分析程序配合使用的可靠方法是调用 GetBufferAsync 方法并分析“xml>”<元素的缓冲区。 然后使用指定的字符编码 (“<xmlversion=”1.0“ encoding=”UTF-8“？>”，例如) 来分析 HTTP 响应正文。 对于其他文本格式，应用扫描 HTTP 响应正文的初始部分以确定使用的字符编码时，可以使用类似的方法。

下面是此函数引发的异常。

E_INVALIDARG

uri 参数是一个 null 引用， (Visual Basic) 中无任何内容。

异常处理

调用此方法时，必须编写代码来处理异常。 异常可能是参数验证错误、名称解析失败和网络错误导致的。 网络错误 (连接丢失、连接故障和 HTTP 服务器故障（例如，随时可能发生) ）的异常。 这些错误将引发异常。 如果应用未处理，则异常可能会导致整个应用被运行时终止。 有关如何处理异常的详细信息，请参阅 处理网络应用中的异常。

适用于

另请参阅