About Guide Data Objects

[This is preliminary documentation and subject to change.]

The following diagram illustrates the inheritance structure of the Guide data objects. In this diagram, CTableNameRecordset represents a recordset object that corresponds to the TableName table in the Guide database, and CTableName represents the record object associated with that recordset object. The objects derived from CDatabaseRecordset represent records in the database. The objects derived from CObject represent the fields within the record.

The CDatabaseConnection class is the base class of the Guide data object set and is used to open and close a workspace and to connect to a database.

The CDatabaseRecordset class is an abstract base class that defines generic recordset functionality. This class provides methods for such operations as adding and deleting records. It inherits from CDatabaseConnection and is in turn inherited by each of the table-specific recordset classes represented by CTableNameRecordset.

The CTableNameRecordset objects expand on the generic recordset functionality inherited from CDatabaseRecordset by re-implementing the GetTableName, GetRecordsetObject, SetRecordsetObject, and Seek methods to be specific to the table that they wrap.

The CTableName objects inherit from the Microsoft® Foundation Classes (MFC) base class, CObject. The CTableName objects are returned by CTableNameRecordset::GetRecordsetObject and each wrap a single record in the table. These objects provide methods that enable you to retrieve or set values for individual fields in records.

To locate more information on CObject, see Further Information on Program Guide Services for the Client.