IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Metode

Definisi

Ruang nama:

Windows.Storage

Membuka aliran akses acak melalui file.

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)

Parameter

accessMode

FileAccessMode

Salah satu nilai enumerasi yang menentukan jenis akses yang diizinkan.

options

StorageOpenOptions

Kombinasi bitwise dari nilai enumerasi yang menentukan opsi untuk membuka aliran.

Mengembalikan

IAsyncOperation<IRandomAccessStream>

Ketika metode ini selesai, metode ini mengembalikan IRandomAccessStream yang berisi aliran akses acak yang diminta.

Atribut

OverloadAttribute RemoteAsyncAttribute

Keterangan

Jika Anda hanya ingin membuka file di aplikasi Anda, lihat metode OpenAsync dari kelas StorageFile .

Dengan menggunakan metode ini, file dapat diakses oleh pembaca file dan penulis secara bersamaan. Berikut ini adalah tabel yang menjelaskan situasi untuk berbagai pengaturan parameter FileAccessMode dan StorageOpenOptions:

	FileAccessMode
StorageOpenOptions	Read	ReadWrite
Tidak ada	Pembaca yang memiliki prioritas lebih rendah daripada penulis. Jika penulisan terjadi, pembaca berprioritas rendah ini akan gagal.	Ini adalah penulis tunggal. File tidak dapat dibuka jika OpenAsync(Read, AllowOnlyReaders) telah digunakan, dan akan mencegah OpenAsync baru (Read, AllowOnlyReaders) digunakan.
AllowOnlyReaders	Pembaca yang hanya dapat ada dengan pembaca lain. Jika terbuka dicoba dengan penulis, itu akan gagal.	Ini adalah penulis tunggal. File tidak dapat dibuka jika OpenAsync(Read, AllowOnlyReaders) telah digunakan, dan akan mencegah OpenAsync baru (Read, AllowOnlyReaders) digunakan.
AllowReadersAndWriters	Pembaca yang dapat ada dengan pembaca dan penulis lain secara bersamaan.	Penulis ini akan membatalkan pembaca berprioritas rendah ketika penulisan terjadi dan dapat hidup berdampingan dengan pembaca dan penulis lain.