Reset method (RDS)
Applies to: Access 2013, Office 2013
Executes the sort or filter on a client-side Recordset based on the specified sort and filter properties.
Syntax
DataControl.Reset(value)
Parameters
| Parameter | Description |
|---|---|
| DataControl | An object variable that represents an RDS.DataControl object. |
| value | Optional. A Boolean value that is True (default) if you want to filter on the current "filtered" rowset. False indicates that you filter on the original rowset, removing any previous filter options. |
Remarks
The SortColumn, SortDirection, FilterValue, FilterCriterion, and FilterColumn properties provide sorting and filtering functionality on the client-side cache. The sorting functionality orders records by values from one column. The filtering functionality displays a subset of records based on a find criteria, while the full Recordset is maintained in the cache. The Reset method will execute the criteria and replace the current Recordset with an updatable Recordset.
If there are changes to the original data that haven't yet been submitted, the Reset method will fail. First, use the SubmitChanges method to save any changes in a read/write Recordset, and then use the Reset method to sort or filter the records.
If you want to perform more than one filter on your rowset, you can use the optional Boolean argument with the Reset method. The following example shows how to do this: