IStorageFile2.OpenTransactedWriteAsync(StorageOpenOptions) Methode

Referenz

Definition

Namespace:: Windows.Storage

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ö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.

Gilt für:

Freigeben über