IRasterWorkspaceEx Interface

Provides access to members that create and open raster catalogs and datasets.

Members

	Name	Description
	CreateRasterCatalog	Creates a new raster catalog.
	CreateRasterDataset	Creates a new raster dataset.
	DeleteRasterCatalog	Deletes a raster catalog.
	DeleteRasterDataset	Deletes a raster dataset.
	OpenRasterCatalog	Opens an existing raster catalog.
	OpenRasterDataset	Opens an existing raster dataset.
	RegisterAsRasterCatalog	Registers as a RasterCatalog.
	RegisterAsRasterDataset	Registers as a RasterDataset.
	SaveAsRasterDataset	Creates a new raster dataset from another seed Raster.

IRasterWorkspaceEx.CreateRasterCatalog Method

Creates a new raster catalog.

Public Function CreateRasterCatalog ( _
    ByVal Name As String, _
    ByVal Fields As IFields, _
    ByVal ShapeFieldName As String, _
    ByVal RasterFieldName As String, _
    ByVal ConfigKeyword As String _
) As IRasterCatalog

public IRasterCatalog CreateRasterCatalog (
    string Name,
    IFields Fields,
    string ShapeFieldName,
    string RasterFieldName,
    string ConfigKeyword
);

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.

IRasterWorkspaceEx.CreateRasterDataset Method

Creates a new raster dataset.

Public Function CreateRasterDataset ( _
    ByVal Name As String, _
    ByVal numBands As Integer, _
    ByVal PixelType As rstPixelType, _
    ByVal StorageDef As IRasterStorageDef, _
    ByVal ConfigKeyword As String, _
    ByVal RasterDef As IRasterDef, _
    ByVal GeometryDef As IGeometryDef _
) As IRasterDataset

public IRasterDataset CreateRasterDataset (
    string Name,
    int numBands,
    rstPixelType PixelType,
    IRasterStorageDef StorageDef,
    string ConfigKeyword,
    IRasterDef RasterDef,
    IGeometryDef GeometryDef
);

Description

The CreateRasterDataset method creates a new empty raster dataset in the geodatabase, whereby it is basically a placeholder for some attributes of a raster dataset, such as the number of bands, pixel type, RASTER column properties, and GEOMETRY column properties. Once you have created an empty raster dataset in the geodatabase, you can append raster data to it by mosaicking. If the GeometryDef argument is not specified, a default GeometryDef will be created using the according values (for example, spatial reference) set in the RasterDef argument. Since the geometry column is not accessed or updated, there is no need to set the GeometryDef when creating a raster dataset.

If cellsize in the RasterStorageDef is not specified or set to NULL, the new raster dataset will have an undefined cellsize, the cellsize will be set to the cellsize of the first raster that is mosaicked to it.

If spatial reference in the RasterDef is not specified or set to NULL, the new raster dataset will have an unknown spatial reference, the spatial reference will be set to the spatial reference of the first raster that is mosaicked to it.

IRasterWorkspaceEx.DeleteRasterCatalog Method

Deletes a raster catalog.

Public Sub DeleteRasterCatalog ( _
    ByVal Name As String _
)

public void DeleteRasterCatalog (
    string Name
);

IRasterWorkspaceEx.DeleteRasterDataset Method

Deletes a raster dataset.

Public Sub DeleteRasterDataset ( _
    ByVal Name As String _
)

public void DeleteRasterDataset (
    string Name
);

IRasterWorkspaceEx.OpenRasterCatalog Method

Opens an existing raster catalog.

Public Function OpenRasterCatalog ( _
    ByVal Name As String _
) As IRasterCatalog

public IRasterCatalog OpenRasterCatalog (
    string Name
);

IRasterWorkspaceEx.OpenRasterDataset Method

Opens an existing raster dataset.

Public Function OpenRasterDataset ( _
    ByVal Name As String _
) As IRasterDataset

public IRasterDataset OpenRasterDataset (
    string Name
);

Remarks

The OpenRasterDataset method opens a raster dataset in the geodatabase. It provides access to the RasterDataset geodatabase workspace.

IRasterWorkspaceEx.RegisterAsRasterCatalog Method

Registers as a RasterCatalog.

Public Sub RegisterAsRasterCatalog ( _
    ByVal Name As String, _
    ByVal OIDFieldName As String, _
    ByVal GeometryDef As IGeometryDef _
)

public void RegisterAsRasterCatalog (
    string Name,
    string OIDFieldName,
    IGeometryDef GeometryDef
);

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.

IRasterWorkspaceEx.RegisterAsRasterDataset Method

Registers as a RasterDataset.

Public Sub RegisterAsRasterDataset ( _
    ByVal Name As String, _
    ByVal GeometryDef As IGeometryDef _
)

public void RegisterAsRasterDataset (
    string Name,
    IGeometryDef GeometryDef
);

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.

IRasterWorkspaceEx.SaveAsRasterDataset Method

Creates a new raster dataset from another seed Raster.

Public Function SaveAsRasterDataset ( _
    ByVal Name As String, _
    ByVal Raster As IRaster, _
    ByVal StorageDef As IRasterStorageDef, _
    ByVal ConfigKeyword As String, _
    ByVal RasterDef As IRasterDef, _
    ByVal GeometryDef As IGeometryDef _
) As IRasterDataset

public IRasterDataset SaveAsRasterDataset (
    string Name,
    IRaster Raster,
    IRasterStorageDef StorageDef,
    string ConfigKeyword,
    IRasterDef RasterDef,
    IGeometryDef GeometryDef
);

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.

Classes that implement IRasterWorkspaceEx

Classes	Description
Workspace	Workspace Object.

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.