Product Documentation

c-treeDB API for C#

Previous Topic

Next Topic

Compile Using Microsoft Visual Studio IDE

This section explains the steps to compile and run the tutorials from the Microsoft Visual Studio IDE. FairCom provides Microsoft Visual Studio solutions for Microsoft Visual Studio 2015, 2017, and 2019. You can find these solutions in the various “Microsoft Visual Studio” directories in the <faircom>\sdk\ctree.isam.net.cs\tutorials\IDEProjects directory. Please choose the one which corresponds to the version of Visual Studio you have installed.

This tutorial requires the Microsoft Windows SDK to be installed on your computer. See Microsoft Windows SDK.

If the FairCom Database Engine is not already running on your machine, start the server as explained in Starting the FairCom Database Engine.

The source code is located in this directory: <faircom>\sdk\ctree.isam.net.cs\tutorials

How to Use the Visual Studio Environment

  1. Load the Tutorials.sln file that corresponds to your version of Visual Studio by double-clicking the .sln file.
  2. To build these samples, use the Build menu of Microsoft Visual Studio and pick the Build Solution item:

    Visual Studio Build

  3. To run the tutorial, choose Start Debugging in the Debug menu or simply press F5.
  4. To fully observe how this tutorial interacts with c-tree, step through the code with the debugger and execute it step-by-step using Step Into from the Debug menu or simply press F11.

By default, the Visual Studio debugger will start the first tutorial project.

INIT

Logon to server...

DEFINE

Open table...

Add fields...

Create table...

MANAGE

Delete records...

Add records...

Display records...

1000 Bryan Williams

1001 Michael Jordan

1002 Joshua Brown

1003 Keyon Dooling

DONE

Close table...

Logout...

Press <ENTER> key to exit . . .

When you are finished with Tutorial1 you can select a different tutorial using the Solution Explorer. Right-click on the desired project and select Set as StartUp Project, then step into the code as described above.

Visual Studio StartUp Project

Note that you might see "Exception thrown: FairCom.CtreeDb.CTException" messages in the Visual Studio debug output window while the tutorials run. These are normal and expected behavior. When a tutorial tries to open a non-existent table using CTTable.Open(), an exception is thrown. It is caught by the code which then creates the non-existent table. This is a normal part of the program lifecycle, and does not indicate erroneous behavior.

Troubleshooting

This section lists some errors you may encounter when compiling and running the tutorials.

Error MSB8036:

The Windows SDK version 10.0.15063.0 was not found. Install the required version of Windows SDK or change the SDK version in the project property pages or by right-clicking the solution and selecting "Retarget solution".

This build error happens because the Windows SDK version that this solution was built against (10.0.15063.0) does not match the Windows SDK version that is currently installed on your computer.

To fix this, right-click on the solution (not one of the individual projects), and select Retarget Solution, and specify a Windows SDK installed on your computer.

The versions of the Windows SDK installed on your computer will be automatically listed. Choose one and click OK to retarget the solution.

ERROR: [133] - c-tree logon error.

The most common cause of this runtime error is the FairCom Database Engine is not running on your machine. The most likely cause is that the c-tree evaluation license times out after 3 hours and shuts down the server. The solution is to restart the server. See the Setting Up the FairCom Server section for how to do this.

TOCIndex