IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) 方法

定义

命名空间:

Windows.Storage

通过文件打开随机访问流。

public:
 IAsyncOperation<IRandomAccessStream ^> ^ OpenAsync(FileAccessMode accessMode, StorageOpenOptions options);

/// [Windows.Foundation.Metadata.Overload("OpenWithOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IRandomAccessStream> OpenAsync(FileAccessMode const& accessMode, StorageOpenOptions const& options);

[Windows.Foundation.Metadata.Overload("OpenWithOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IRandomAccessStream> OpenAsync(FileAccessMode accessMode, StorageOpenOptions options);

function openAsync(accessMode, options)

Public Function OpenAsync (accessMode As FileAccessMode, options As StorageOpenOptions) As IAsyncOperation(Of IRandomAccessStream)

参数

accessMode

FileAccessMode

指定要允许的访问类型的枚举值之一。

options

StorageOpenOptions

枚举值的按位组合，指定用于打开流的选项。

返回

IAsyncOperation<IRandomAccessStream>

此方法完成后，它将返回一个 IRandomAccessStream ，其中包含请求的随机访问流。

属性

OverloadAttribute RemoteAsyncAttribute

注解

如果只想在应用中打开文件，请参阅 StorageFile 类的 OpenAsync 方法。

使用此方法，文件读取器和编写器可以同时访问文件。 下表描述了 FileAccessMode 和 StorageOpenOptions 的各种参数设置的情况：

	FileAccessMode
StorageOpenOptions	读取	ReadWrite
无	优先级低于编写器的读取器。 如果发生写入，此低优先级读取器将失败。	这是单个编写器。 如果已使用 OpenAsync (Read、AllowOnlyReaders) ，则无法打开该文件，并且会阻止使用新的 OpenAsync (Read、AllowOnlyReaders) 。
AllowOnlyReaders	只能与其他读取器一起存在的读取器。 如果尝试使用编写器打开，它将失败。	这是单个编写器。 如果已使用 OpenAsync (Read、AllowOnlyReaders) ，则无法打开该文件，并且会阻止使用新的 OpenAsync (Read、AllowOnlyReaders) 。
AllowReadersAndWriters	可以与其他读取器和写入器同时存在的读取器。	当写入时，此编写器将使低优先级读取器失效，并且可以与其他读取器和编写器共存。