Updates the XY, M, Z extent.
[Visual Basic 6.0] Sub UpdateExtent
[Visual Basic .NET] Public Sub UpdateExtent ( _ )
[C#] public void UpdateExtent ( );
[Java] public void updateExtent ( ) throws IOException, AutomationException
[C++] HRESULT UpdateExtent( void );
The UpdateExtent method recalculates the XY, Z and M extent for a feature class, based on the features contained within it. This extent is returned by the IGeodataset.Extent property. As new features are added to a feature class in a geodatabase, or a shapefile feature class, the extent is automatically expanded to accomodate them, however, when features are deleted, the extent does not shrink to eliminate areas where there are no longer features. This method will shrink the extent of the feature class to eliminate these areas.
The extent is a property of the feature class' schema, therefore, it requires an exclusive schema lock to execute, and is not an undoable operation. In the case of personal geodatabase and ArcSDE feature classes, the M and Z extent are not stored with the class. In the case of shapefiles, the M and Z extents are stored with the feature class.
When calling this method against an ArcSDE feature class, the extent is calculated based on the features that exist for that feature class in all versions. The extent will not shrink unless this method is called after the database has been compressed.
This method is not supported on coverage feature classes. A coverage's extent is maintained automatically during the editing process.