| Platform SDK: Broadcast Architecture |
The CDatabaseRecordset class is an abstract base class that provides the root encapsulation for recordset manipulation. CDatabaseRecordset inherits from the CDatabaseConnection class.
Each class in the Dbsets.dll library that inherits from CDatabaseRecordset is named in the format CTableNameRecordset, where TableName is the name of the table the class represents.
The CDatabaseRecordset class provides the following methods.
| Method | Description |
|---|---|
| OpenRecordset | Initializes a recordset object in the Guide database. |
| OpenRecordsetQueryDef | Initializes a recordset object with the results of the specified query. |
| CloseRecordset | Clears the data from a recordset object. |
| GetQueryPrefix | Returns the first part of a SQL query string. Your application can add SQL commands such as WHERE to this string to make a query. |
| GetRecordCount | Counts the number of records in a recordset. |
| GetRecord | Returns a pointer to the specified record. |
| GotoRecord | Jumps to the specified record in a recordset. |
| FindRecord | Locates a record in a recordset. |
| InsertRecord | Adds the specified record to a recordset. |
| UpdateRecord | Updates the current record in a recordset. |
| DeleteRecord | Deletes the current record from a recordset. |
| OpenIndexed | Opens a recordset and creates an index for it. |
| SeekAddRS | Looks for a matching record. If one is found, its field values are updated with those of the record object passed. |
| UpdateRS | Updates a record. |
| StartUpdateRS | Updates a record, keeping it open for further editing. |
| EndUpdateRS | Updates and completes editing of a record opened for editing by the StartUpdateRS method. |
| Edit | Calls directly into an underlying DAO recordset to start an editing operation. |
| Update | Calls directly into an underlying DAO recordset to complete an editing operation. |
| GetLongField | Returns the value of the specified LONG field of a record in the recordset. |
| GetField | Returns the value of the specified field of a record in the recordset. The GetField method is overloaded for specific fields by classes that inherit from CDatabaseRecordset. You can specify the field whose value to return using either the field name or its index in the field list. |
| SetField | Sets the value of the specified field of a record in a recordset. |
| GetTableName | Returns the name of the table associated with the CTableNameRecordset object. This method is implemented by the recordset objects that inherit from CDatabaseRecordset. |
CDatabaseRecordset also defines the following protected methods. These methods are re-implemented by the CTableNameRecordset objects that inherit from CDatabaseRecordset.
| Protected method | Description |
|---|---|
| SetRecordsetObject | Sets a record in a Guide database table to the values of a specified record object. |
| GetRecordsetObject | Returns a record object. |
| Seek | Indicates whether the specified object is in the recordset. |
For more information on the inheritance structure of the Guide data objects, see About Guide Data Objects.
Windows NT/2000: Unsupported.
Windows 95/98: Requires Windows 98.
Header: Declared in dbsets.h.
Import Library: Use dbsets.lib or dbsetsst.lib.