IRandomAccessStreamReference 接口

  • 参考

定义

命名空间:
Windows.Storage.Streams
编辑

允许Windows 运行时组件提供对封装流的访问。

public interface class IRandomAccessStreamReference
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(871248180, 7638, 20026, 128, 103, 209, 193, 98, 232, 100, 43)]
struct IRandomAccessStreamReference
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(871248180, 7638, 20026, 128, 103, 209, 193, 98, 232, 100, 43)]
public interface IRandomAccessStreamReference
Public Interface IRandomAccessStreamReference
派生
属性
ContractVersionAttribute GuidAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

当Windows 运行时组件向调用方公开随机访问流时，实现 IRandomAccessStreamReference 接口。 对于顺序只读流，实现 IInputStreamReference 接口。

例如， StorageFile 为文件的内容提供 IRandomAccessStream ，因此它实现 IRandomAccessStreamReference 接口。 通常，提供流需要访问硬盘，因此流操作是异步的。 使用文件内容的组件接收 IRandomAccessStreamReference 而不是 StorageFile 引用，因为此接口是输入参数的最低要求。

重要

并非所有源都可以有效地提供随机访问流。 如果组件只需要顺序读取访问权限，请考虑实现 IInputStreamReference 接口，而不是 IRandomAccessStreamReference 接口。

方法

OpenReadAsync()

打开用于随机访问的流。

适用于

另请参阅