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


IRasterTransaction Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > DataSourcesRaster > ESRI.ArcGIS.DataSourcesRaster > Interfaces > IR > IRasterTransaction Interface
ArcGIS Developer Help

IRasterTransaction Interface

Provides access to members that provide undo support.

Product Availability

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

Members

Name Description
Method Commit Sends all pending changes to persistent storage.
Method End Commits changes and stops double buffering.
Method Start Starts double buffering edits for undo support.
Method Undo Reverses last N changes.
Write-only property UndoLevels Maximum number of reversible operations.
Read-only property UndoLevels Maximum number of reversible operations.

Classes that implement IRasterTransaction

Classes Description
RasterBand A representation of a single band of a raster dataset on disk.

Remarks

This interface is supported on a file based RasterBand, not supported on a database RasterBand.

This interface allows you to setup and maintain a transaction stack that can revert from changes that have been made in memory before persisting these changes raster band. In this mechanism, a transaction is defined as either a write called on the dataset outside a double-buffered transaction or a set of writes contained within a single Start/End transaction block. The Start and End methods allow you to perform multiple writes that are managed by the undo stack as a single transaction.

To enable the transactioning mechanism, a band cache must first be created and then the undo level must be specified. To create the cache, call the AcquireCache method on the IRawPixels interface. After you are done editing, free the cache using the ReturnCache method.

 

This interface only works with raster in IMG, TIFF and GRID formats in ArcGIS 9.2

 

See Also

IRasterBand Interface | IPixelBlock Interface