Resync Method
Refreshes the data in the current Recordset
object from the underlying database.
Syntax
recordset.Resync AffectRecords
The Resync method syntax has these parts:
|
Part
|
Description
|
|
recordset
|
An object variable representing an open Recordset object.
|
|
AffectRecords
|
Optional. An AffectEnum value that determines how many records the Resync
method will affect. Can be one of the following constants:
|
|
|
adAffectCurrent, 1 ¾ Refresh only the
current record.
adAffectGroup, 2 ¾ Refresh the records that
satisfy the current Filter property setting. You
must set the Filter property to one of the valid predefined constants
in order to use this option.
adAffectAll, 3 (Default) ¾ Refresh all the
records in the Recordset object, including any hidden by the current Filter
property setting.
|
Remarks
Use the Resync method to re-synchronize records in the current Recordset
with the underlying database. This is useful if you are using either a static
or forward-only cursor but you want to see any changes in the underlying
database. Calling the Resync method cancels any pending batch updates.
Unlike the Refresh method, the Resync
method does not re-execute the Recordset object's underlying
command; new records in the underlying database will not be visible.
If the attempt to resynchronize fails because of a conflict with the
underlying data (for example, a record has been deleted by another user), the
provider returns warnings to the Errors collection
but does not halt program execution. A run-time error occurs only if there are
conflicts on all the requested records. Use the Filter property (adFilterAffectedRecords)
and the Status property to locate records with
conflicts.
Applies To
Recordset
See Also
Clear, UnderlyingValue
|