IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Apre un flusso ad accesso casuale sul 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)

Parametri

accessMode

FileAccessMode

Uno dei valori di enumerazione che specifica il tipo di accesso da consentire.

options

StorageOpenOptions

Combinazione bit per bit dei valori di enumerazione che specificano le opzioni per l'apertura del flusso.

Restituisce

IAsyncOperation<IRandomAccessStream>

Al termine di questo metodo, restituisce un oggetto IRandomAccessStream che contiene il flusso di accesso casuale richiesto.

Attributi

OverloadAttribute RemoteAsyncAttribute

Commenti

Se vuoi semplicemente aprire un file nell'app, vedi il metodo OpenAsync della classe StorageFile .

Usando questo metodo, è possibile accedere a un file sia dai lettori di file che dai writer contemporaneamente. Di seguito è riportata una tabella che descrive le situazioni per varie impostazioni dei parametri di FileAccessMode e StorageOpenOptions:

	FileAccessMode
StorageOpenOptions	Read	ReadWrite
Nessuno	Lettore con priorità inferiore rispetto a un writer. Se si verifica una scrittura, questo lettore con priorità bassa avrà esito negativo.	Si tratta di un singolo writer. Il file non può essere aperto se è stato usato OpenAsync(Read, AllowOnlyReaders) e impedirà l'uso di un nuovo OpenAsync(Read, AllowOnlyReaders).
AllowOnlyReaders	Lettore che può esistere solo con altri lettori. Se si tenta un'apertura con un writer, l'operazione avrà esito negativo.	Si tratta di un singolo writer. Il file non può essere aperto se è stato usato OpenAsync(Read, AllowOnlyReaders) e impedirà l'uso di un nuovo OpenAsync(Read, AllowOnlyReaders).
AllowReadersAndWriters	Lettore che può esistere con altri lettori e scrittori contemporaneamente.	Questo writer invaliderà i lettori con priorità bassa quando si verifica una scrittura e può coesistere con altri lettori e scrittori.