|
DaoRecordset:Requery() Method |
  
|
|
DaoRecordset:Requery() Method |
|
Purpose
Re-executes the query the recordset is based on
Parameters
| oQueryDef | (Optional). A QueryDef object (Microsoft Jet workspaces only). |
Returns
NIL
Remarks
Use this method to make sure that a Recordset contains the most recent data. This method re-populates the current Recordset by using either the current query parameters or (in a Microsoft Jet workspace) the new ones supplied by the oQueryDef argument.
In an ODBCDirect workspace, if the original query was asynchronous, then Requery will also execute an asynchronous query.
If you don't specify a oQueryDef argument, the Recordset is re-populated based on the same query definition and parameters used to originally populate the Recordset. Any changes to the underlying data will be reflected during this re-population. If you didn't use a QueryDef to create the Recordset, the Recordset is re-created from scratch.
If you specify the original QueryDef in the oQueryDef argument, then the Recordset is requeried using the parameters specified by the QueryDef. Any changes to the underlying data will be reflected during this re-population. To reflect any changes to the query parameter values in the Recordset, you must supply the oQueryDeff argument.
If you specify a different QueryDef than what was originally used to create the Recordset, the Recordset is re-created from scratch.
When you use Requery, the first record in the Recordset becomes the current record.
You can't use the Requery method on dynaset- or snapshot-type Recordset objects whose Restartable
property is set to False. However, if you supply the optional oQueryDef argument, the Restartable property is ignored.
If both the BOF and EOF property settings of the Recordset object are True after you use the Requery method, the query didn't return any records and the Recordset contains no data.
Class