Synergex.SynergyDE.Select.ChangeTracking

View and manipulate snapshot information for a file

namespace Synergex.SynergyDE.Select
public sealed class ChangeTracking

The ChangeTracking class returns snapshot information for a file, enabling you to perform change tracking functions from within your program rather than spawning a ctutl command. See Change tracking for an overview of change tracking and Understanding the Synergy Change Tracking API for more information about the Synergy change tracking API.

Constructors

ChangeTracking

public ChangeTracking(filename)

Creates the snapshot information object for the specified ISAM file (the ctutl filename) (a) in the Snapshots arrayed field.

Properties

ChangeTrackingEnabled

protected property ChangeTrackingEnabled

Indicates whether change tracking is enabled. Implements a get method that returns true if the file has change tracking enabled or false if change tracking is not enabled. (boolean)

Methods

ApplySnapshot

public ApplySnapshot(), void

Synchronizes the file with the ChangeTracking snapshot.

Any activity that occurs after snapshots are enabled is tracked in a pseudo snapshot. This pseudo snapshot is always the last one in the list, but it isn’t an actual snapshot; it just contains all of the activity since the last snapshot. When the ApplySnapshot() method is invoked, a new snapshot is created that contains the contents of the pseudo snapshot, and a new pseudo snapshot begins tracking any new activity. The Snapshots field contains both SnapshotInfo structure information for each snapshot as well as post-snapshot information from the pseudo snapshot.

If change tracking is not enabled, an error will occur.

Refresh

public Refresh(), void

Updates the Snapshots array with the file’s current information.

Fields

Snapshots

An arrayed field that will be populated with the SnapshotInfo structure information for each snapshot, as well as information about the activity that occurred after the last snapshot. ([#]SnapshotInfo)