次の方法で共有


IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) メソッド

定義

ファイル上のランダム アクセス ストリームを開きます。

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

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

戻り値

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

属性

注釈

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

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

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

適用対象