5-Minute Quick Start

  • Download latest stable release (Downloads section)
  • Create a folder named Lib in your project and copy the binaries from Release or Debug folder there
  • Add a reference to ChinhDo.Transactions.dll
  • Write some code (see example below) that manipulate files in a transaction

Code example:

// Completely unrealistic example showing how various file operations, including operations done
// by library/3rd party code, can participate in transactions.
IFileManager fileManager = new TxFileManager();
using (TransactionScope scope1 = new TransactionScope())
    fileManager.WriteAllText(inFileName, xml);

    // Snapshot allows any file operation to be part of our transaction.
    // All we need to know is the file name.
    //The statement below tells the TxFileManager to remember the state of this file.
    // So even though XslCompiledTransform has no knowledge of our TxFileManager, the file it creates (outFileName)
    // will still be restored to this state in the event of a rollback.
    XslCompiledTransform xsl = new XslCompiledTransform(true);
    xsl.Transform(inFileName, outFileName);

    // write to database 1. This database op will get committed/rolled back along with the file operations we are doing in this transaction.

    // write to database 2. The transaction is promoted to a distributed transaction here.

    // let's delete some files
    for (string fileName in filesToDelete)

    // Just for kicks, let's start a new nested  transaction. Since we specify RequiresNew here, this nested transaction
    // will be committed/rolled back separately from the main transaction.
    // Note that we can still use the same fileManager instance. It knows how to sort things out correctly.
    using (TransactionScope scope2 = new TransactionScope(TransactionScopeOptions.RequiresNew))
        fileManager.MoveFile(anotherFile, anotherFileDest);

    // move some files
    for (string fileName in filesToMove)
        fileManager.Move(fileName, GetNewFileName(fileName));

    // Finally, let's create a few temporary files...
    // disk space has to be used for something.
    // The nice thing about FileManager.GetTempFileName is that
    // The temp file will be cleaned up automatically for you when the TransactionScope completes.
    // No more worries about temp files that get left behind.
    for (int i=0; i<10; i++)
        fileManager.WriteAllText(fileManager.GetTempFileName(), "testing 1 2");

    // In the event an exception occurs, everything done here will be rolled back including the output xsl file.


Want more examples? Check out the unit tests included in the latest Release download (in Source.zip).

Last edited Jun 11, 2010 at 3:19 PM by chinhdo, version 3


jcvegan Oct 16, 2015 at 7:12 PM 
What if I want to create a file from Stream?