How to synchronize a replica in a connected environment

Summary

This topic shows how to synchronize a replica in a connected environment using ArcObjects. A connected environment is one in which both replica geodatabases are connected on a local area network (LAN) or a wide area network (WAN) during replica creation. This topic assumes that a replica has already been created and is ready to be synchronized.

Synchronizing a replica in a connected environment

1. Connect to the geodatabase containing the parent replica and connect to the geodatabase containing the child replica. This requires initializing a GeoDataServer object for each connection. GeoDataServer objects allow access to a geodatabase on a LAN or a WAN through ArcGIS for Server. For more information on how to initialize a GeoDataServer, see How to initialize a GeoDataServer object.
2. Call the following procedure. To do this, paste it into an application, and call it passing in the following parameters:
   

[C#]

// Synchronizes a replica in a connected environment.
public void SynchronizeReplica(IGeoDataServer parentGDS, IGeoDataServer childGDS,
    String replicaName, esriReplicationAgentReconcilePolicy conflictPolicy,
    esriReplicaSynchronizeDirection syncDirection, Boolean columnLevel)
{
    try
    {
        // Iterate through the replicas of the parent GeoDataServer.
        IGPReplicas gpReplicas=parentGDS.Replicas;
        IGPReplica parentReplica=null;
        for (int i=0; i < gpReplicas.Count; i++)
        {
            // See if the unqualified replica name matches the replicaName parameter.
            IGPReplica currentReplica=gpReplicas.get_Element(i);
            String currentReplicaName=currentReplica.Name;
            int dotIndex=currentReplicaName.LastIndexOf(".") + 1;
            String baseName=currentReplicaName.Substring(dotIndex,
                currentReplicaName.Length - dotIndex);
            if (baseName.ToLower() == replicaName.ToLower())
            {
                parentReplica=currentReplica;
                break;
            }
        }

        // Check to see if the parent replica was found.
        if (parentReplica == null)
        {
            throw new ArgumentException(
                "The requested replica could not be found on the parent GDS.");
        }

        // Iterate through the replica of the child GeoDataServer.
        gpReplicas=childGDS.Replicas;
        IGPReplica childReplica=null;
        for (int i=0; i < gpReplicas.Count; i++)
        {
            // See if the unqualified replica name matches the replicaName parameter.
            IGPReplica currentReplica=gpReplicas.get_Element(i);
            String currentReplicaName=currentReplica.Name;
            int dotIndex=currentReplicaName.LastIndexOf(".") + 1;
            String baseName=currentReplicaName.Substring(dotIndex,
                currentReplicaName.Length - dotIndex);
            if (baseName.ToLower() == replicaName.ToLower())
            {
                childReplica=currentReplica;
                break;
            }
        }

        // Check to see if the child replica was found.
        if (childReplica == null)
        {
            throw new ArgumentException(
                "The requested replica could not be found on the child GDS.");
        }

        // Synchronize the replica.
        IReplicationAgent replicationAgent=new ReplicationAgentClass();
        replicationAgent.SynchronizeReplica(parentGDS, childGDS, parentReplica,
            childReplica, conflictPolicy, syncDirection, columnLevel);
    }
    catch (COMException comExc)
    {
        throw new Exception(String.Format(
            "Create replica errored: {0}, Error Code: {1}", comExc.Message,
            comExc.ErrorCode), comExc);
    }
    catch (Exception exc)
    {
        throw new Exception(String.Format("Create replica errored: {0}", exc.Message)
            , exc);
    }
}

[VB.NET]

' Synchronizes a replica in a connected environment.

Public Sub SynchronizeReplica(ByVal parentGDS As IGeoDataServer, ByVal childGDS As IGeoDataServer, ByVal replicaName As String, ByVal conflictPolicy As esriReplicationAgentReconcilePolicy, ByVal syncDirection As esriReplicaSynchronizeDirection, ByVal columnLevel As Boolean)
    
    Try
    ' Iterate through the replicas of the parent GeoDataServer.
    Dim gpReplicas As IGPReplicas=parentGDS.Replicas
    Dim parentReplica As IGPReplica=Nothing
    For i As Integer=0 To gpReplicas.Count - 1
        ' See if the unqualified replica name matches the replicaName parameter.
        Dim currentReplica As IGPReplica=gpReplicas.Element(i)
        Dim currentReplicaName As String=currentReplica.Name
        Dim dotIndex As Integer=currentReplicaName.LastIndexOf(".") + 1
        Dim baseName As String=currentReplicaName.Substring(dotIndex, currentReplicaName.Length - dotIndex)
        If baseName.ToLower()=replicaName.ToLower() Then
            parentReplica=currentReplica
            Exit For
        End If
    Next i
    
    ' Check to see if the parent replica was found.
    If parentReplica Is Nothing Then
        Throw New ArgumentException("The requested replica could not be found on the parent GDS.")
    End If
    
    ' Iterate through the replica of the child GeoDataServer.
    gpReplicas=childGDS.Replicas
    Dim childReplica As IGPReplica=Nothing
    For i As Integer=0 To gpReplicas.Count - 1
        ' See if the unqualified replica name matches the replicaName parameter.
        Dim currentReplica As IGPReplica=gpReplicas.Element(i)
        Dim currentReplicaName As String=currentReplica.Name
        Dim dotIndex As Integer=currentReplicaName.LastIndexOf(".") + 1
        Dim baseName As String=currentReplicaName.Substring(dotIndex, currentReplicaName.Length - dotIndex)
        If baseName.ToLower()=replicaName.ToLower() Then
            childReplica=currentReplica
            Exit For
        End If
    Next i
    
    ' Check to see if the child replica was found.
    If childReplica Is Nothing Then
        Throw New ArgumentException("The requested replica could not be found on the child GDS.")
    End If
    
    ' Synchronize the replica.
    Dim replicationAgent As IReplicationAgent=New ReplicationAgentClass()
    replicationAgent.SynchronizeReplica(parentGDS, childGDS, parentReplica, childReplica, conflictPolicy, syncDirection, columnLevel)
    
    Catch comExc As COMException
    Throw New Exception(String.Format("Create replica errored: {0}, Error Code: {1}", comExc.Message, comExc.ErrorCode), comExc)
    Catch exc As Exception
    Throw New Exception(String.Format("Create replica errored: {0}", exc.Message), exc)
    End Try
    
End Sub

---

To use the code in this topic, reference the following assemblies in your Visual Studio project. In the code files, you will need using (C#) or Imports (VB .NET) directives for the corresponding namespaces (given in parenthesis below if different from the assembly name):

• System.Runtime.InteropServices
• ESRI.ArcGIS.System (ESRI.ArcGIS.esriSystem)
• ESRI.ArcGIS.Geodatabase
• ESRI.ArcGIS.GeoDatabaseDistributed

Development licensing	Deployment licensing
ArcGIS Desktop Standard	ArcGIS Desktop Standard
ArcGIS Desktop Advanced	ArcGIS Desktop Advanced
Engine Developer Kit	Engine: Geodatabase Update