Product Documentation

VCL/CLX Developers Guide

Previous Topic

Next Topic

Programmer's Reference

This chapter provides step-by-step instructions for integration of the c-treeVCL/CLX components into applications.

  • A session represents a connection between a client and a c-tree server; no work can be performed before a session becomes active. The session handle indicates the c-treeDB session, the server name and location, the directory where the databases are located, the user name and password.
  • A database can be considered as a collection of tables, and each database has its own database dictionary that stores information about each table that belongs to that database. This includes the table name, password, path, the active (open) tables, and the number of tables linked to the database. The database handle indicates a database in the session and each session can have multiple databases.
  • A table is essentially a c-tree Plus data, and optionally, index files. There can be, and typically are, more than one table in a database, and a given table may belong to multiple databases. A Table may have zero or more records.
  • A field is the basic element of a table, and a collection of fields forms a data record.

Often a table will have zero or more indexes, which enhances the retrieval of records from that table.

Indexes typically have one or more segments describing the index key structure. The index handle indicates an index associated with a particular table, while the segment links the index with the fields.

A record is essentially an entry row in a table. A record handle indicates a record instance on a particular table. A table may have one or more record handles associated with it. Each record handle may be an independent cursor into the table, or several record handles may share the same cursor into the table.

In This Chapter

Modifying Component Properties

Error handling

Using the Session Component

Using the Database Component

Using the Table Component

Working without the Visual Components

Data Integrity

c-treeVCL- Working with Resources

Compatibility with other c-tree API Technologies

TOCIndex