IInputStream.ReadAsync(IBuffer, UInt32, InputStreamOptions) 方法

定义

命名空间:

Windows.Storage.Streams

以异步方式从流中读取数据。

public:
 IAsyncOperationWithProgress<IBuffer ^, unsigned int> ^ ReadAsync(IBuffer ^ buffer, unsigned int count, InputStreamOptions options);

IAsyncOperationWithProgress<IBuffer, uint32_t> ReadAsync(IBuffer const& buffer, uint32_t const& count, InputStreamOptions const& options);

public IAsyncOperationWithProgress<IBuffer,uint> ReadAsync(IBuffer buffer, uint count, InputStreamOptions options);

function readAsync(buffer, count, options)

Public Function ReadAsync (buffer As IBuffer, count As UInteger, options As InputStreamOptions) As IAsyncOperationWithProgress(Of IBuffer, UInteger)

参数

buffer

IBuffer

可用于返回读取的字节的缓冲区。 返回值包含保存结果的缓冲区。

count

UInt32

unsigned int

uint32_t

小于或等于 Capacity 值的要读取的字节数。

options

InputStreamOptions

指定异步读取操作的类型。

返回

IAsyncOperationWithProgress<IBuffer,UInt32>

Windows.Foundation.IAsyncOperationWithProgress<Windows.Storage.Streams.IBuffer,unsigned int>

IAsyncOperationWithProgress<IBuffer,uint32_t>

异步操作。

示例

使用此方法的示例应用程序包括 HttpClient 示例。

注解

始终从 IAsyncOperationWithProgress (IBuffer、UInt32) 中返回的缓冲区读取数据。 不要假定输入缓冲区包含数据。 根据实现的不同，读取的数据可能放置在输入缓冲区中，也可能在不同的缓冲区中返回。 对于输入缓冲区，无需实现 IBuffer 接口。 相反，可以创建 Buffer 类的实例。

此外，请考虑使用 DataReader 类的 ReadBuffer 方法将缓冲区读入 IInputStream。

另请参阅

• HttpClient 示例