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

許可するアクセスの種類を指定する列挙値の 1 つ。

options

StorageOpenOptions

ストリームを開くオプションを指定する列挙値のビットごとの組み合わせ。

戻り値

IAsyncOperation<IRandomAccessStream>

このメソッドが完了すると、要求されたランダム アクセス ストリームを含む IRandomAccessStream が返されます。

属性

OverloadAttribute RemoteAsyncAttribute

注釈

アプリでファイルを開くだけの場合は、StorageFile クラスの OpenAsync メソッドを参照してください。

このメソッドを使用すると、ファイル リーダーとライターの両方から同時にファイルにアクセスできます。 FileAccessMode と StorageOpenOptions のさまざまなパラメーター設定の状況を説明する表を次に示します。

	FileAccessMode
StorageOpenOptions	Read	ReadWrite
なし	ライターよりも優先順位が低いリーダー。 書き込みが行われると、この優先度の低いリーダーは失敗します。	これは 1 つのライターです。 OpenAsync(Read, AllowOnlyReaders) が使用されていて、新しい OpenAsync(Read, AllowOnlyReaders) が使用されない場合、ファイルを開くことができません。
AllowOnlyReaders	他のリーダーとのみ存在できるリーダー。 ライターを使用してオープンを試みると、失敗します。	これは 1 つのライターです。 OpenAsync(Read, AllowOnlyReaders) が使用されていて、新しい OpenAsync(Read, AllowOnlyReaders) が使用されない場合、ファイルを開くことができません。
AllowReadersAndWriters	他のリーダーおよびライターと同時に存在できるリーダー。	このライターは、書き込みが発生したときに優先度の低いリーダーを無効にし、他のリーダーやライターと共存できます。