Freigeben über


IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Methode

Definition

Öffnet einen Datenstrom mit zufälligem Zugriff über die Datei.

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

Einer der Enumerationswerte, der den Typ des zuzulassenden Zugriffs angibt.

options
StorageOpenOptions

Eine bitweise Kombination der Enumerationswerte, die Optionen zum Öffnen des Datenstroms angeben.

Gibt zurück

Nach Abschluss dieser Methode wird ein IRandomAccessStream zurückgegeben, der den angeforderten Datenstrom für zufälligen Zugriff enthält.

Attribute

Hinweise

Wenn Sie einfach eine Datei in Ihrer App öffnen möchten, lesen Sie die OpenAsync-Methode der StorageFile-Klasse .

Mit dieser Methode kann gleichzeitig auf eine Datei zugegriffen werden. Die folgende Tabelle beschreibt die Situationen für verschiedene Parametereinstellungen von FileAccessMode und StorageOpenOptions:

FileAccessMode
StorageOpenOptions Lesen ReadWrite
Keine Ein Leser, der eine niedrigere Priorität hat als ein Schreiber. Wenn ein Schreibvorgang auftritt, tritt bei diesem Leseprogramm mit niedriger Priorität ein Fehler auf. Dies ist ein einzelner Writer. Die Datei kann nicht geöffnet werden, wenn OpenAsync(Read, AllowOnlyReaders) verwendet wurde, und es wird verhindert, dass ein neues OpenAsync(Read, AllowOnlyReaders) verwendet wird.
AllowOnlyReaders Ein Leser, der nur mit anderen Lesern existieren kann. Wenn ein Geöffnet mit einem Writer versucht wird, schlägt dies fehl. Dies ist ein einzelner Writer. Die Datei kann nicht geöffnet werden, wenn OpenAsync(Read, AllowOnlyReaders) verwendet wurde, und es wird verhindert, dass ein neues OpenAsync(Read, AllowOnlyReaders) verwendet wird.
AllowReadersAndWriters Ein Leser, der mit anderen Lesern und Autoren gleichzeitig existieren kann. Dieser Schreiber ungültigiert Leser mit niedriger Priorität, wenn ein Schreibvorgang auftritt und mit anderen Lesern und Autoren koexistieren kann.

Gilt für: