Microsoft Jet and Replication Objects

ConflictFunction Property

See Also        Applies To

Indicates the name of the custom conflict resolution function to use in resolving conflicts during synchronization.

Settings and Return Values

Sets or returns a String value that is the name of a custom function. The String must be less than 256 characters long. The default value is an empty string ("").

Remarks

The ConflictFunction property enables you to use custom conflict resolution code for resolving data conflicts that occur between replicas upon synchronization, or it can designate one replica in the set to view the built-in Conflict Resolver. Set the ConflictFunction property to a text string that is the name of the function you wish to call. Note that the setting must be the name of a Function procedure; it can't be the name of a Sub procedure. If this property has not been set, Microsoft Access calls the built-in Conflict Resolver.

A conflict occurs if the same record in a replicated database has been changed in one or more replicas (or the same column in the same record if column level tracking is enabled for the database). Normally, Microsoft Access calls the built-in Conflict Resolver to resolve these conflicts. The Conflict Resolver wizard presents each conflict to the user, who must manually determine which changed record contains the correct data. You can designate one replica in the replication set to view conflicts with the built-in Conflict Resolver by setting the ConflictFunction property to be equal to the ReplicaId (GUID) of that replica.

If you prefer to automate conflict resolution for your application, you can write custom procedures to resolve conflicts, and then override the built-in functionality by setting the ConflictFunction property. You should create a single function that acts as a point of entry into your conflict resolution code, then set the ConflictFunction property to the name of this function.

This property can only be read or set if the database is replicable. An error will occur if the ReplicaType is jrRepTypeNotReplicable and the user attempts to read or set this property. An error will also occur if the ReplicaType is jrRepTypeDesignMaster.