HttpClient.GetBufferAsync(Uri) 方法

定义

将 GET 请求发送到指定的 URI,并在异步操作中将响应正文作为缓冲区返回。 有关 HttpClient 类的编程指南和代码示例,请参阅 HttpClient 概念主题。

public:
 virtual IAsyncOperationWithProgress<IBuffer ^, HttpProgress> ^ GetBufferAsync(Uri ^ uri) = GetBufferAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<IBuffer, HttpProgress> GetBufferAsync(Uri const& uri);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<IBuffer,HttpProgress> GetBufferAsync(System.Uri uri);
function getBufferAsync(uri)
Public Function GetBufferAsync (uri As Uri) As IAsyncOperationWithProgress(Of IBuffer, HttpProgress)

参数

uri
Uri Uri

请求发送到的 URI。

返回

表示异步操作的 对象。

属性

注解

下载二进制内容(如小图像和压缩文件)时,通常调用此方法。 应使用 HttpClient.GetInputStreamAsync 将非常大的二进制内容下载为流,以防止不必要的缓冲。

此操作不会阻止。 返回的 IAsyncOperationWithProgress (IBufferHttpProgress) 在读取整个响应正文后完成。

应用通常使用 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) 中无任何内容

适用于

另请参阅