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	讀取	讀寫
無	優先順序低於寫入器的讀取器。 如果寫入發生，這個低優先順序讀取器將會失敗。	這是單一寫入器。 如果已使用 OpenAsync (Read、AllowOnlyReaders) ，且會防止使用新的 OpenAsync (Read、AllowOnlyReaders) ，則無法開啟檔案。
AllowOnlyReaders	只能與其他讀取器一起存在的讀取器。 如果嘗試使用寫入器開啟，它將會失敗。	這是單一寫入器。 如果已使用 OpenAsync (Read、AllowOnlyReaders) ，且會防止使用新的 OpenAsync (Read、AllowOnlyReaders) ，則無法開啟檔案。
AllowReadersAndWriters	可同時與其他讀取器和寫入器一起存在的讀取器。	當寫入發生時，此寫入器會將低優先順序讀取器失效，並可與其他讀取器和寫入器共存。