StorageStreamTransaction Klasse

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

Stellt eine Schreibtransaktion für einen Datenstrom mit zufälligem Zugriff dar.

public ref class StorageStreamTransaction sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageStreamTransaction final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageStreamTransaction : System.IDisposable

Public NotInheritable Class StorageStreamTransaction
Implements IDisposable

Vererbung: Object Platform::Object IInspectable StorageStreamTransaction

Attribute: ContractVersionAttribute

Implementiert: IClosable IDisposable

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Im Dateizugriffsbeispiel wird gezeigt, wie Sie ein StorageStreamTransaction-Objekt verwenden, um einen transaktionierten Schreibvorgang für eine Datei auszuführen.

try
{
    if (file != null)
    {
        using (StorageStreamTransaction transaction = await file.OpenTransactedWriteAsync())
        {
            using (DataWriter dataWriter = new DataWriter(transaction.Stream))
            {
                dataWriter.WriteString("Swift as a shadow");
                transaction.Stream.Size = await dataWriter.StoreAsync(); // reset stream size to override the file
                await transaction.CommitAsync();
            }
        }
    }
}
// Use catch blocks to handle errors
catch (FileNotFoundException)
{
    // For example, handle a file not found error
}

Im Beispiel ist eine lokale Variable, file die eine StorageFile-Datei enthält, die die zu schreibende Datei darstellt.

Eigenschaften

Stream

Ruft den zufälligen Zugriffsdatenstrom ab, der in der Transaktion verwendet wird.

Methoden

Close()	Gibt Systemressourcen frei, die vom Stream verfügbar gemacht werden, was angibt, dass die Datenanforderung abgeschlossen ist.
CommitAsync()	Speichern Sie den Stream in der zugrunde liegenden Datei.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

Gilt für:

Freigeben über