StorageStreamTransaction 类

定义

命名空间:

Windows.Storage

表示随机访问流的写入事务。

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

继承

Object Platform::Object IInspectable StorageStreamTransaction

属性

ContractVersionAttribute

实现

IClosable IDisposable

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

文件访问示例演示如何使用 StorageStreamTransaction 对象对文件执行事务处理写入操作。

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
}

在此示例中， file 是一个局部变量，其中包含表示要写入的文件的 StorageFile 。

属性

Stream

获取事务中使用的随机访问流。

方法

Close()	释放由流公开的系统资源，指示数据请求已完成。
CommitAsync()	将流保存到基础文件。
Dispose()	执行与释放或重置非托管资源关联的应用程序定义的任务。

另请参阅

• IClosable
• 文件访问示例