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()

アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。

適用対象

こちらもご覧ください