A representation of a raster dataset on disk.
Product Availability
Description
The RasterDataset object represents a dataset on disk or in a geodatabase. It is composed of one or more persistent raster bands.
The RasterDataset object performs basic dataset management functions, such as copy, rename, and delete. It can also be used to examine dataset properties including raster format, extent, spatial reference, and number of bands, etc.
RasterDataset can be used to change some of the properties of the dataset. For example, RasterDataset can be used to change the spatial reference associated with the dataset, to manipulate the colormap of the raster dataset, to build pyramids (reduced-resolution datasets) which improve display performance for large raster datasets, and to build statistics which enhances raster renderering. RasterDataset object can merge pixels from another raster dataset to itself.
A RasterDataset can be saved to anther file format or geodatabase using ISaveAs or IRasterBandCollection.
The IRasterWorkspace interface and IRasterWorkspaceEx interface, through an Access workspace, create a file based RasterDataset; IRasterWorkspaceEx interface, through a database workspace, creates a database RasterDataset.
A file based RasterDataset and database RasterDataset work the same way except on a few interfaces. For example, ITemporyDataset and IWorldFileExport interfaces are not supported by a database RasterDataset.
Supported Platforms
Extended Error Information
Use the ISupportErrorInfo method InterfaceSupportsErrorInfo to determine if the object supports extended error information. If the object supports extended error info, VC++ developers should use the OLE/COM IErrorInfo interface to access the ErrorInfo object. Visual Basic developers should use the global error object Err to retrieve this extended error information.
Interfaces
| Interfaces | Description |
|---|---|
| IDataset (esriGeoDatabase) | Provides access to members that supply dataset information. |
| IDatasetAnalyze (esriGeoDatabase) | Provides access to members that analyze a dataset. |
| IDatasetFileStat (esriGeoDatabase) | Provides access to members that control Dataset file-based statistics. |
| IGeoDataset (esriGeoDatabase) | Provides access to members that provide information about a Geographic Dataset. |
| IGeoDatasetSchemaEdit (esriGeoDatabase) | Provides access to members that change the schema of a GeoDataset. |
| IMetadata (esriGeoDatabase) | Provides access to members that manage and update metadata. |
| IMetadataEdit (esriGeoDatabase) | Provides access to members that provide information about whether metadata can be edited. |
| INativeTypeInfo (esriGeoDatabase) | Provides access to the native type. |
| IRasterBandCollection | Provides access to members that control a collection of RasterBands. |
| IRasterDataset (esriGeoDatabase) | Provides access to members that control a raster dataset. |
| IRasterDataset2 (esriGeoDatabase) | Provides access to members that control a raster dataset. |
| IRasterDataset3 (esriGeoDatabase) | Provides access to members that control a RasterDataset. |
| IRasterDatasetEdit (esriGeoDatabase) | Provides access to members that control raster dataset level editing operations. |
| IRasterDatasetEdit2 (esriGeoDatabase) | Provides access to members that control editing of a RasterDataset. |
| IRasterDatasetEdit3 (esriGeoDatabase) | Provides access to members that control editing of a RasterDataset. |
| IRasterDatasetJukebox | Provides access to members that control subdatasets. |
| IRasterPyramid | Provides access to members that control the pyramids for a raster dataset. |
| IRasterPyramid2 | Provides access to members that control the pyramids for a raster dataset. |
| IRasterPyramid3 | Provides access to members that control the pyramids for a raster dataset. |
| IRawBlocks | Provides access to members that control raw pixel block access. |
| ISaveAs (esriGeoDatabase) | Provides access to methods for saving as a new Dataset. |
| ISaveAs2 (esriGeoDatabase) | Provides access to methods for saving as a new Raster Dataset. |
| ISupportErrorInfo | Indicates whether a specific interface can return Automation error objects. |
| ITemporaryDataset | Provides access to members that control temporary datasets. |
| IWorldFileExport | Provides access to members that export Georeference information to a WorldFile. |
| IWorldFileExport2 | Provides access to members that export georeferencing and spatial reference. |
Remarks
The RasterDataset object represents a dataset on disk or in a database. It is composed of one or more persistent raster bands. The dataset provides access only to operations that apply to the entire dataset, with the RasterBand providing access to operations that occur on individual bands.
The RasterDataset object performs basic dataset management functions, such as copy, rename, and delete. It can also instantiat RasterBand and Raster objects representing other aspects of the data. It can be used to examine dataset properties including different format, extent, spatial reference, and number of bands.
The spatial reference of the raster raster dataset can be changed through interface IGeoDatasetSchemaEdit, but it does not project the dataset, only changes the coordinate system associated with the dataset.
The pyramid of the raster dataset can be built or rebuilt to improve display performance for large raster datasets.