StorageStreamTransaction Klasse

  • Referenz

Definition

Namespace:
Windows.Storage
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:

Weitere Informationen