StorageStreamTransaction class (Windows)

0 out of 1 rated this helpful - Rate this topic

Represents a write transaction for a random-access stream.

Syntax


var storageStreamTransaction = openTransactedWriteAsync();

Attributes

MarshalingBehaviorAttribute(Agile)
VersionAttribute(NTDDI_WIN8)

Members

The StorageStreamTransaction class has these types of members:

Methods
Properties

Methods

The StorageStreamTransaction class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.

Method	Description
Close [C++, JavaScript]	Releases system resources that are exposed by the stream, indicating that the data request is complete.
CommitAsync	Save the stream to the underlying file.
Dispose [C#, VB]	Performs tasks associated with freeing, releasing, or resetting unmanaged resources.

Properties

The StorageStreamTransaction class has these properties.

Property	Access type	Description
Stream	Read-only	Gets the random-access stream used in the transaction.

Examples

The File Access sample shows you how to use a StorageStreamTransaction object to perform a transacted write operation on a file.

JavaScript



if ( file !== null) {
    file.openTransactedWriteAsync().then(
        function (transaction) {
            var dataWriter = new Windows.Storage.Streams.DataWriter(transaction.stream);
            dataWriter.writeString("Swift as a shadow");
            dataWriter.storeAsync().then(function (size) {
                transaction.stream.size = size; // reset stream size to override the file
                transaction.commitAsync().done(function () {
                    // Text written to file

                    // Close stream
                    transaction.close();
                });
            });
        },
        // Handle errors with an error function
        function (error) {
            // Proccess errors
        }
    );
}

In the example, file is a local variable that contains a storageFile that represents the file to write.

Requirements

Minimum supported client	Windows 8 [Windows Store apps only]
Minimum supported server	Windows Server 2012 [Windows Store apps only]
Minimum supported phone	Windows Phone 8
Namespace	Windows.Storage Windows::Storage [C++]
Metadata	Windows.winmd

StorageStreamTransaction class