com.esri.arcgis.datasourcesraster
Interface ITemporaryDataset

All Superinterfaces:

Serializable

All Known Implementing Classes:

FunctionRasterDataset, RasterDataset

public interface ITemporaryDataset
extends Serializable

Provides access to members that control temporary datasets.

Remarks

This interface is not supported by a RasterDataset instance from an ArcSDE geodatabase or a File geodatabase.

Temporary raster datasets are created by most operations performed by the Spatial Analyst Extension and also can be created using IRasterWorkspace2::CreateRasterDataset method.

MakePermanent method change the status of a dataset from temporary to permanent. If the dataset is permanent, MakePermanent does nothing.

MakePermanentAs method makes the current dataset permanent by creating a new raster dataset that contains the same data. The current raster dataset will be deleted when all references to it are released. The supported output formats are same as ISaveAs.

When To Use

Temporary raster datasets can delete themselves if they are not referenced by any application. ITemporaryDataset interface supports temporary raster datasets. It is used to make temporary raster datasets permanent.

Product Availability

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

Method Summary

boolean	isTemporary() Indicates if the dataset is temporary.
void	makePermanent() Persists this temporary dataset permanent.
IDataset	makePermanentAs(String new_name, IWorkspace workspace, String format) Persists this temporary dataset to a new permanent dataset.

Method Detail

isTemporary

boolean isTemporary()
                    throws IOException,
                           AutomationException

Indicates if the dataset is temporary.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The temporary

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

makePermanent

void makePermanent()
                   throws IOException,
                          AutomationException

Persists this temporary dataset permanent.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

makePermanentAs

IDataset makePermanentAs(String new_name,
                         IWorkspace workspace,
                         String format)
                         throws IOException,
                                AutomationException

Persists this temporary dataset to a new permanent dataset.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

new_name - The new_name (in)

workspace - A reference to a com.esri.arcgis.geodatabase.IWorkspace (in)

format - The format (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.IDataset

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.