Interface IRasterWorkspaceEx
- Namespace
- ESRI.ArcGIS.Geodatabase
- Assembly
- ESRI.Server.Geodatabase.dll
Provides access to members that create and open raster catalogs and datasets.
[Guid("C8778A65-0E27-4CB5-9A50-A7471B398EA7")]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
public interface IRasterWorkspaceEx
Remarks
The IRasterWorkspaceEx interface works with raster datasets and raster catalogs in the geodatabase. It allows the creation of new raster datasets and raster catalogs in the geodatabase, it also opens and deletes existing raster datasets and raster catalogs in the geodatabase. The IRasterWorkspaceEx interface also allows saving a given raster to a raster dataset in the geodatabase. Its counterpart is IRasterWorkspace and IRasterWorkspace2 that works with file-based rasters.
Methods
CreateRasterCatalog(string, IFields, string, string, string)
Creates a new raster catalog.
IRasterCatalog CreateRasterCatalog(string Name, IFields Fields, string ShapeFieldName, string RasterFieldName, string ConfigKeyword)
Parameters
Returns
Remarks
The CreateRasterCatalog method creates a new empty raster catalog in a Personal, File or ArcSDE geodatabase. At releases prior to 9.2, When you create a raster catalog, you need to set the x/y domain on the GeometryDef properly to cover the extents of all the rasters you will be loading to the raster catalog. If the extent of a raster dataset is beyond the specified x/y domain of the GeometryDef, it will not be loaded. Since 9.2, the x/y domain is optimized according to the spatial reference of the geometry column, so you do not need to set it manually.
CreateRasterDataset(string, int, rstPixelType, IRasterStorageDef, string, IRasterDef, IGeometryDef)
Creates a new raster dataset.
IRasterDataset CreateRasterDataset(string Name, int numBands, rstPixelType PixelType, IRasterStorageDef StorageDef, string ConfigKeyword, IRasterDef RasterDef, IGeometryDef GeometryDef)
Parameters
NamestringnumBandsintPixelTyperstPixelTypeStorageDefIRasterStorageDefConfigKeywordstringRasterDefIRasterDefGeometryDefIGeometryDef
Returns
DeleteRasterCatalog(string)
Deletes a raster catalog.
void DeleteRasterCatalog(string Name)
Parameters
Namestring
DeleteRasterDataset(string)
Deletes a raster dataset.
void DeleteRasterDataset(string Name)
Parameters
Namestring
OpenRasterCatalog(string)
Opens an existing raster catalog.
IRasterCatalog OpenRasterCatalog(string Name)
Parameters
Namestring
Returns
OpenRasterDataset(string)
Opens an existing raster dataset.
IRasterDataset OpenRasterDataset(string Name)
Parameters
Namestring
Returns
Remarks
The OpenRasterDataset method opens a raster dataset in the geodatabase. It provides access to the RasterDataset geodatabase workspace.
RegisterAsRasterCatalog(string, string, IGeometryDef)
Registers as a RasterCatalog.
void RegisterAsRasterCatalog(string Name, string OIDFieldName, IGeometryDef GeometryDef)
Parameters
NamestringOIDFieldNamestringGeometryDefIGeometryDef
Remarks
The RegisterAsRasterCatalog method provides a way to upgrade an 8.x embedded raster catalog to a 9.x raster catalog, because an 8.x raster catalog doesn’t have an OID or a GEOMETRY type column in its business table while a 9.x raster catalog does. This method will add these two columns to the raster catalog table and populate the Geometry column with the extent of each raster dataset in the raster catalog. This method works only with ArcSDE geodatabase.
RegisterAsRasterDataset(string, IGeometryDef)
Registers as a RasterDataset.
void RegisterAsRasterDataset(string Name, IGeometryDef GeometryDef)
Parameters
NamestringGeometryDefIGeometryDef
Remarks
The RegisterAsRasterDataset method allows you to upgrade an 8.x raster dataset to a 9.x raster dataset in ArcSDE geodatabase, because an 8.x raster dataset doesn’t have a GEOMETRY column in its business table while a 9.x raster dataset does. This method only applies to ArcSDE geodatabase raster dataset. It is necessary to register an 8.x raster dataset to a 9.x raster dataset in order for the raster dataset to be recognized in any Geoprocessing tools.
SaveAsRasterDataset(string, IRaster, IRasterStorageDef, string, IRasterDef, IGeometryDef)
Creates a new raster dataset from another seed Raster.
IRasterDataset SaveAsRasterDataset(string Name, IRaster Raster, IRasterStorageDef StorageDef, string ConfigKeyword, IRasterDef RasterDef, IGeometryDef GeometryDef)
Parameters
NamestringRasterIRasterStorageDefIRasterStorageDefConfigKeywordstringRasterDefIRasterDefGeometryDefIGeometryDef
Returns
Remarks
The SaveAsRasterDataset method provides a way to save any raster as a raster dataset in the geodatabase. It is similar to the CreateRasterDataset method, but instead of creating an empty raster dataset, it copies the input raster properties and pixels to the output raster dataset in the geodatabase. If you want to keep the spatial reference of the input raster dataset for both raster column and geometry column, you can pass nothing to the RasterDef argument and GeometryDef argument.