FileRandomAccessStream 类

定义

命名空间:

Windows.Storage.Streams

支持在指定位置读取和写入文件。

public ref class FileRandomAccessStream sealed : IClosable, IRandomAccessStream

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileRandomAccessStream final : IClosable, IRandomAccessStream

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileRandomAccessStream : System.IDisposable, IRandomAccessStream

Public NotInheritable Class FileRandomAccessStream
Implements IDisposable, IRandomAccessStream

继承

Object Platform::Object IInspectable FileRandomAccessStream

属性

ContractVersionAttribute MarshalingBehaviorAttribute

实现

IClosable IDisposable IInputStream IOutputStream IRandomAccessStream

Windows 要求

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

注解

版本历史记录

Windows 版本	SDK 版本	增值
1709	16299	OpenAsync (String，FileAccessMode)
1709	16299	OpenAsync (String，FileAccessMode，StorageOpenOptions，FileOpenDisposition)
1709	16299	OpenForUserAsync (User，String，FileAccessMode)
1709	16299	OpenForUserAsync (User，String，FileAccessMode，StorageOpenOptions，FileOpenDisposition)
1709	16299	OpenTransactedWriteAsync (字符串)
1709	16299	OpenTransactedWriteAsync (String，StorageOpenOptions，FileOpenDisposition)
1709	16299	OpenTransactedWriteForUserAsync (User，String)
1709	16299	OpenTransactedWriteForUserAsync (User，String，StorageOpenOptions，FileOpenDisposition)

属性

CanRead	获取一个值，该值指示是否可以从中读取流。
CanWrite	获取一个值，该值指示是否可以将文件写入。
Position	获取流的字节偏移量。
Size	获取或设置随机访问流的大小。

方法

CloneStream()	在当前流所在的资源上创建 IRandomAccessStream 的新实例。
Close()	关闭当前流并释放系统资源。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。
FlushAsync()	在顺序流中异步刷新数据。
GetInputStreamAt(UInt64)	返回流中指定位置的输入流。
GetOutputStreamAt(UInt64)	返回流中指定位置的输出流。
OpenAsync(String, FileAccessMode)	在给定文件路径的情况下打开指向现有文件的流。
OpenAsync(String, FileAccessMode, StorageOpenOptions, FileOpenDisposition)	在给定文件路径的情况下打开指向文件的流。 如果该文件不存在，可以使用 FileOpenDisposition 创建它。
OpenForUserAsync(User, String, FileAccessMode)	在给定文件路径和用户信息的情况下，为用户打开到现有文件的流。
OpenForUserAsync(User, String, FileAccessMode, StorageOpenOptions, FileOpenDisposition)	在给定文件路径和用户信息的情况下，为用户打开文件流。 如果该文件不存在，可以使用 FileOpenDisposition 创建它。
OpenTransactedWriteAsync(String)	打开一个流，以便在给定文件路径的情况下写入现有文件。
OpenTransactedWriteAsync(String, StorageOpenOptions, FileOpenDisposition)	在给定文件路径的情况下打开要写入文件的流。 如果该文件不存在，可以使用 FileOpenDisposition 创建它。
OpenTransactedWriteForUserAsync(User, String)	在给定文件路径和用户信息的情况下，为用户打开现有文件的可写流。
OpenTransactedWriteForUserAsync(User, String, StorageOpenOptions, FileOpenDisposition)	在给定文件路径和用户信息的情况下，为用户打开文件可写流。 如果该文件不存在，可以使用 FileOpenDisposition 创建它。
ReadAsync(IBuffer, UInt32, InputStreamOptions)	返回异步字节读取器对象。
Seek(UInt64)	将流的位置设置为指定值。
WriteAsync(IBuffer)	将数据异步写入文件。

另请参阅

• FileInputStream
• FileOutputStream
• InMemoryRandomAccessStream
• RandomAccessStream