This document is archived and information here might be outdated.  Recommended version.


IGeoDataServer.ExportReplicaDataChanges Method (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (GeoDatabaseDistributed)  

IGeoDataServer.ExportReplicaDataChanges Method

Exports data changes for a replica.

[Visual Basic .NET]
Public Function ExportReplicaDataChanges ( _
    ByVal ReplicaName As String, _
    ByVal options As IGDSExportOptions, _
    ByVal TransportType As esriGDSTransportType, _
    ByVal generationsToExport As esriExportGenerationsOption, _
    ByVal switchRole As Boolean _
) As IGDSData
[C#]
public IGDSData ExportReplicaDataChanges (
    string ReplicaName,
    IGDSExportOptions options,
    esriGDSTransportType TransportType,
    esriExportGenerationsOption generationsToExport,
    bool switchRole
);
[C++]
HRESULT ExportReplicaDataChanges(
  BSTR ReplicaName,
  IGDSExportOptions* options,
  esriGDSTransportType TransportType,
  esriExportGenerationsOption generationsToExport,
  VARIANT_BOOL switchRole,
  IGDSData** result
);
[C++]

Parameters ReplicaName [in] ReplicaName is a parameter of type BSTR options [in]
options is a parameter of type IGDSExportOptions TransportType [in]
TransportType is a parameter of type esriGDSTransportType generationsToExport [in]
generationsToExport is a parameter of type esriExportGenerationsOption switchRole [in] switchRole is a parameter of type VARIANT_BOOL result [out, retval]
result is a parameter of type IGDSData

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Remarks

The ExportReplicaDataChanges method is used to export data changes from a replica. Use this method when synchronizing replicas in a disconnected environment. To synchronize replicas in a connected environment, see IReplicationAgent::SynchronizeReplica.

This method should be used in conjunction with the IGeoDataServer::ImportReplicaDataChanges method to complete the transfer of data changes from one replica to it's relative. Note that this method can only be executed for replicas that are data senders. See IGPReplica::ReplicaState for more information.

The ReplicaName is the name of the replica from which to export changes.

The options parameter defines the output of the method. This includes the outut format and whether or not the output will be compressed. See GDSExportOptions for more information.

The TransportType indicates the desired transport type.  Use esriGDSTransportTypeURL to place the output in a file in the virtual output directory. Use esriGDSTransportTypeEmbedded to have the results embedded in the output GDSData object. If no virtual output directory exists, the results will be embedded regardless of the value set for this parameter.

The generationsToExport parameter uses the esriExportGenerationsOption enumeration to specify what data changes to export.  You may choose to export only unacknowledged data change, only new data changes, all data changes, or no data changes. You would export no data changes if you were interested in switching roles (see below). See the esriExportGenerationsOptions enumeration for more information.

Set the switchRole parameter to true if after exporting the data changes, you want to start receiving changes from the relative replica. When set to true, the source replica transitions from a data sender to a data receiver upon export. When the relative replica successfully imports this delta file, it transitions from a data receiver to a data sender.  See the ImportReplicaDataChanges method for more information.

When executed, the method returns a GDSData object. See the GDSData coclass for more information.

[C#]

The How to synchronize a data change message in a disconnected environment topic shows how to use this method.

See Also

IGeoDataServer Interface

.NET Related Topics

How to synchronize a data change message in a disconnected environment