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

IChangeDatabaseVersion.Execute Method (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IC > IChangeDatabaseVersion Interface > IChangeDatabaseVersion.Execute Method
ArcGIS Developer Help

IChangeDatabaseVersion.Execute Method

Replaces the version of the feature classes for all the layers that belong to the From version to To version.

[Visual Basic .NET]
Public Function Execute ( _
    ByVal pFrom As IVersion, _
    ByVal pTo As IVersion, _
    ByVal pMap As IBasicMap _
) As ISet
public ISet Execute (
    IVersion pFrom,
    IVersion pTo,
    IBasicMap pMap
HRESULT Execute(
  IVersion* pFrom,
  IVersion* pTo,
  IBasicMap* pMap
pFrom [in]

pFrom is a parameter of type IVersion* pTo [in]
pTo is a parameter of type IVersion* pMap [in]
pMap is a parameter of type IBasicMap*

Product Availability

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


The Execute method is used to change the version of versioned data from one version to another.  The versions can be transactional or historical.  The input parameters of this method are:

pFrom: The version to move away from.  Only layers with a data source referencing this version will be changed.

pTo: The version to change to.

pMap: An IBasicMap reference, which could be a Map, Globe, or Scene, that contains the layers to be changed.

The return parameter of the method is a set of table and layer references of the layers that had their version changed.


This command fires the following events:

IActiveViewEvents::ContentsChanged when executed on a Map, Scene, or Globe.

Additionally the events IMapEvents::FeatureClassChanged and IMapEvents2::TableChanged are fired for each layer and table respectively when changing the version on a Map.

When executing this method on a Map, you may wish to call IMapAdmin::FireChangeVersion prior to performing the version change to additionally notify listeners of the change.

See Also

IChangeDatabaseVersion Interface