IStorageFile2.OpenAsync(FileAccessMode, StorageOpenOptions) Methode

Definition

Namespace:

Windows.Storage

Ö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

IAsyncOperation<IRandomAccessStream>

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

Attribute

OverloadAttribute RemoteAsyncAttribute

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.