CDaoRecordset Class Members
Data Members
Construction
Attributes
Recordset Update Operations
Recordset Navigation Operations
Other Recordset Operations
Overridables
Data Members
| m_bCheckCacheForDirtyFields | Contains a flag indicating whether fields are automatically marked as changed. |
| m_pDAORecordset | A pointer to the DAO interface underlying the recordset object. |
| m_nFields | Contains the number of field data members in the recordset class and the number of columns selected by the recordset from the data source. |
| m_nParams | Contains the number of parameter data members in the recordset class — the number of parameters passed with the recordset's query |
| m_pDatabase | Source database for this result set. Contains a pointer to a CDaoDatabase object. |
| m_strFilter | Contains a string used to construct an SQL WHERE statement. |
| m_strSort | Contains a string used to construct an SQL ORDER BY statement. |
Construction
| CDaoRecordset | Constructs a CDaoRecordset object. |
| Close | Closes the recordset. |
| Open | Creates a new recordset from a table, dynaset, or snapshot. |
Attributes
| CanAppend | Returns nonzero if new records can be added to the recordset via the AddNew member function. |
| CanBookmark | Returns nonzero if the recordset supports bookmarks. |
| CanRestart | Returns nonzero if Requery can be called to run the recordset’s query again. |
| CanScroll | Returns nonzero if you can scroll through the records. |
| CanTransact | Returns nonzero if the data source supports transactions. |
| CanUpdate | Returns nonzero if the recordset can be updated (you can add, update, or delete records). |
| GetCurrentIndex | Returns a CString containing the name of the index most recently used on an indexed, table-type CDaoRecordset. |
| GetDateCreated | Returns the date and time the base table underlying a CDaoRecordset object was created |
| GetDateLastUpdated | Returns the date and time of the most recent change made to the design of a base table underlying a CDaoRecordset object. |
| GetEditMode | Returns a value that indicates the state of editing for the current record. |
| GetLastModifiedBookmark | Used to determine the most recently added or updated record. |
| GetName | Returns a CString containing the name of the recordset. |
| GetParamValue | Retrieves the current value of the specified parameter stored in the underlying DAOParameter object. |
| GetRecordCount | Returns the number of records accessed in a recordset object. |
| GetSQL | Gets the SQL string used to select records for the recordset. |
| GetType | Called to determine the type of a recordset: table-type, dynaset-type, or snapshot-type. |
| GetValidationRule | Returns a CString containing the value that validates data as it is entered into a field. |
| GetValidationText | Retrieves the text that is displayed when a validation rule is not satisfied. |
| IsBOF | Returns nonzero if the recordset has been positioned before the first record. There is no current record. |
| IsDeleted | Returns nonzero if the recordset is positioned on a deleted record. |
| IsEOF | Returns nonzero if the recordset has been positioned after the last record. There is no current record. |
| IsFieldDirty | Returns nonzero if the specified field in the current record has been changed. |
| IsFieldNull | Returns nonzero if the specified field in the current record is Null (having no value). |
| IsFieldNullable | Returns nonzero if the specified field in the current record can be set to Null (having no value). |
| IsOpen | Returns nonzero if Open has been called previously. |
| SetCurrentIndex | Called to set an index on a table-type recordset. |
| SetParamValue | Sets the current value of the specified parameter stored in the underlying DAOParameter object |
| SetParamValueNull | Sets the current value of the specified parameter to Null (having no value). |
Recordset Update Operations
| AddNew | Prepares for adding a new record. Call Update to complete the addition. |
| CancelUpdate | Cancels any pending updates due to an Edit or AddNew operation. |
| Delete | Deletes the current record from the recordset. You must explicitly scroll to another record after the deletion. |
| Edit | Prepares for changes to the current record. Call Update to complete the edit. |
| Update | Completes an AddNew or Edit operation by saving the new or edited data on the data source. |
Recordset Navigation Operations
| Find | Locates the first, next, previous, or last location of a particular string in a dynaset-type recordset that satisfies the specified criteria and makes that record the current record. |
| FindFirst | Locates the first record in a dynaset-type or snapshot-type recordset that satisfies the specified criteria and makes that record the current record. |
| FindLast | Locates the last record in a dynaset-type or snapshot-type recordset that satisfies the specified criteria and makes that record the current record. |
| FindNext | Locates the next record in a dynaset-type or snapshot-type recordset that satisfies the specified criteria and makes that record the current record. |
| FindPrev | Locates the previous record in a dynaset-type or snapshot-type recordset that satisfies the specified criteria and makes that record the current record. |
| GetAbsolutePosition | Returns the record number of a recordset object’s current record. |
| GetBookmark | Returns a value that represents the bookmark on a record. |
| GetPercentPosition | Returns the position of the current record as a percentage of the total number of records. |
| Move | Positions the recordset to a specified number of records from the current record in either direction. |
| MoveFirst | Positions the current record on the first record in the recordset. |
| MoveLast | Positions the current record on the last record in the recordset. |
| MoveNext | Positions the current record on the next record in the recordset . |
| MovePrev | Positions the current record on the previous record in the recordset. |
| Seek | Locates the record in an indexed table-type recordset object that satisfies the specified criteria for the current index and makes that record the current record. |
| SetAbsolutePosition | Sets the record number of a recordset object’s current record. |
| SetBookmark | Positions the recordset on a record containing the specified bookmark. |
| SetPercentPosition | Sets the position of the current record to a location corresponding to a percentage of the total number of records in a recordset. |
Other Recordset Operations
| FillCache | Fills all or a part of a local cache for a recordset object that contains data from an ODBC data source. |
| GetCacheSize | Returns a value that specifies the number of records in a dynaset-type recordset containing data to be locally cached from an ODBC data source. |
| GetCacheStart | Returns a value that specifies the bookmark of the first record in the recordset to be cached. |
| GetFieldCount | Returns a value that represents the number of fields in a recordset. |
| GetFieldInfo | Returns specific kinds of information about the fields in the recordset. |
| GetFieldValue | Returns the value of a field in a recordset. |
| GetIndexCount | Retrieves the number of indexes in a table underlying a recordset. |
| GetIndexInfo | Returns various kinds of information about an index. |
| GetLockingMode | Returns a value that indicates the type of locking that is in effect during editing. |
| Requery | Runs the recordset’s query again to refresh the selected records. |
| SetCacheSize | Sets a value that specifies the number of records in a dynaset-type recordset containing data to be locally cached from an ODBC data source. |
| SetCacheStart | Sets a value that specifies the bookmark of the first record in the recordset to be cached. |
| SetFieldDirty | Marks the specified field in the current record as changed. |
| SetFieldNull | Sets the value of the specified field in the current record to Null (having no value). |
| SetFieldValue | Sets the value of a field in a recordset. |
| SetFieldValueNull | Sets the value of a field in a recordset to Null. (having no value). |
| SetLockingMode | Sets a value that indicates the type of locking to put into effect during editing. |
Overridables
| DoFieldExchange | Called to exchange data (in both directions) between the field data members of the recordset and the corresponding record on the data source. Implements DAO record field exchange (DFX). |
| GetDefaultDBName | Returns the name of the default data source. |
| GetDefaultSQL | Called to get the default SQL string to execute. |
CDaoRecordset Overview | Base Class Members | Hierarchy Chart