Product Documentation

c-treeDB API for C#

Previous Topic

Next Topic

Tutorial 4: Transaction Processing

<faircom>\drivers\csharp.nav\tutorials\Tutorial4.cs

Now we will discuss transaction processing as it relates to the c-tree Database API for C#.

Transaction processing provides a safe method by which multiple database operations spread across separate tables/files are guaranteed to be atomic. By atomic, we mean that, within a transaction, either all of the operations succeed or none of the operations succeed. This "either all or none" atomicity ensures that the integrity of the data in related tables/files is secure.

Like all other examples in the c-tree tutorial series, this tutorial simplifies the creation and use of a database into four simple steps: Initialize(), Define(), Manage(), and You’re Done()!

Tutorial #4: Transaction Processing

Here we demonstrate transaction control.

  • Initialize() - Connects to the FairCom Database Engine.
  • Define() - Defines and creates our four tables/files.
  • Manage() - Adds rows/records to multiple tables/files under transaction control.
  • Done() - Disconnects from FairCom Database Engine.

Note our simple Main() function:

using System;

using FairCom.CtreeDb;

using FairCom.CtreeDb.ENUMS;

namespace Tutorial4

{

class Tutorial4

{

static CTSession MySession;

static CTTable tableCustOrdr;

static CTTable tableOrdrItem;

static CTTable tableItemMast;

static CTTable tableCustMast;

static CTRecord recordCustOrdr;

static CTRecord recordOrdrItem;

static CTRecord recordItemMast;

static CTRecord recordCustMast;

//

// main()

//

// The main() function implements the concept of "init, define, manage

// and you're done..."

//

[STAThread]

static void Main(string[] args)

{

Initialize();

Define();

Manage();

Done();

Console.WriteLine("\nPress <ENTER> key to exit . . .");

Console.ReadLine();

}

We suggest opening the source code with your own editor.

Continue now to review these four steps.

In This Section

Init

Define

Manage

Done

TOCIndex