IStorageFile2.OpenTransactedWriteAsync(StorageOpenOptions) Methode

Definition

Namespace:

Windows.Storage

Öffnet einen Datenstrom mit zufälligem Zugriff auf die Datei, die für Transacted-Write-Vorgänge mit den angegebenen Optionen verwendet werden kann.

public:
 IAsyncOperation<StorageStreamTransaction ^> ^ OpenTransactedWriteAsync(StorageOpenOptions options);

/// [Windows.Foundation.Metadata.Overload("OpenTransactedWriteWithOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageStreamTransaction> OpenTransactedWriteAsync(StorageOpenOptions const& options);

[Windows.Foundation.Metadata.Overload("OpenTransactedWriteWithOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageStreamTransaction> OpenTransactedWriteAsync(StorageOpenOptions options);

function openTransactedWriteAsync(options)

Public Function OpenTransactedWriteAsync (options As StorageOpenOptions) As IAsyncOperation(Of StorageStreamTransaction)

Parameter

options

StorageOpenOptions

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

Gibt zurück

IAsyncOperation<StorageStreamTransaction>

Wenn diese Methode abgeschlossen ist, gibt sie eine StorageStreamTransaction zurück, die den Datenstrom für zufälligen Zugriff und Methoden enthält, die zum Abschließen von Transaktionen verwendet werden können.

Attribute

OverloadAttribute RemoteAsyncAttribute

Hinweise

Diese Methode führt zu einem Stream, der in eine temporäre Datei schreibt und dann die Schreibvorgänge atomar in die tatsächliche Datei committet, indem die temporäre Datei in die tatsächliche Datei umbenannt wird. Aufgrund der Funktionsweise des Streamschreibvorgangs kann ein transaktionsfähiger Writer nicht mit einem anderen Writer vorhanden sein, d. h. StorageOpenOptions.AllowReadersAndWriters ist für diese Methode ungültig und gibt bei Verwendung E_INVALIDARG zurück.