com.esri.arcgis.geodatabase
Interface IDatasetName

All Superinterfaces:

Serializable

All Known Subinterfaces:

IAMSDatasetName, IDatasetName2

All Known Implementing Classes:

AMSDatasetName, CacheRasterDatasetName, CadastralFabricName, CadDrawingName, CoverageFeatureClassName, CoverageName, FeatureClassName, FeatureDatasetName, FeatureQueryName, FgdbFeatureClassName, FgdbTableName, FunctionRasterDatasetName, GeometricNetworkName, GPToolboxName, GPToolName, IDatasetNameProxy, MemoryRelationshipClassName, MosaicDatasetName, NetCDFFeatureClassName, NetCDFRasterDatasetName, NetCDFTableName, NetworkDatasetName, ObjectClassName, QueryTableName, RasterBandName, RasterCatalogName, RasterDatasetName, RelationshipClassName, RelQueryTableName, RepresentationClassName, RouteEventSourceName, SchematicDatasetName, SchematicDiagramClassName, SchematicDiagramName, SchematicFolderName, SchematicWorkspaceName, SdeRasterTableName, TableName, TableQueryName, TerrainName, TinName, TopologyName, XYEventSourceName

public interface IDatasetName
extends Serializable

Provides access to members that supply dataset name information.

Superseded By

IDatasetName2

Remarks

DatasetName is an abstract class that covers Name objects for datasets in a workspace.

DatasetName objects identify and locate datasets within a workspace. In addition they may carry additional properties that describe the named dataset. DatasetName objects supports methods to access metadata for the named object (via the optional IMetadata interface) and to manage privileges for the dataset (via the ISQLPrivilege interface).

The DatasetName object for any existing dataset can be obtained by reading the IDataset::FullName property. DatasetName objects may also be created to specify new datasets that are to be created by some operation.

The IDatasetName interface provides access to the basic properties of a dataset name object.

The Name property returns the identifier for the dataset within the context of its workspace. Note that the value of the name property of the dataset name object (IDatasetName::Name) is the same as the value of the name property for the dataset (IDataset::Name). The WorkspaceName property returns the workspace name object for the workspace containing the dataset being specified by this dataset name object.

You can use the IDataset::FullName property to get a dataset name object from the actual dataset object.

A dataset name can also refer to a dataset that does not yet exist. This is useful when creating new data, for example with the feature data converters.

Product Availability

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

Method Summary

String	getCategory() The category of the dataset.
String	getName() The name of the dataset.
IEnumDatasetName	getSubsetNames() Subset names contained within this dataset name.
int	getType() The type of the dataset.
IWorkspaceName	getWorkspaceName() The WorkspaceName of the DatasetName.
void	setCategory(String category) The category of the dataset.
void	setName(String name) The name of the dataset.
void	setWorkspaceNameByRef(IWorkspaceName workspaceName) The WorkspaceName of the DatasetName.

Method Detail

getName

String getName()
               throws IOException,
                      AutomationException

The name of the dataset.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The name

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setName

void setName(String name)
             throws IOException,
                    AutomationException

The name of the dataset.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

name - The name (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getType

int getType()
            throws IOException,
                   AutomationException

The type of the dataset.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A com.esri.arcgis.geodatabase.esriDatasetType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCategory

String getCategory()
                   throws IOException,
                          AutomationException

The category of the dataset.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The category

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCategory

void setCategory(String category)
                 throws IOException,
                        AutomationException

The category of the dataset.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

category - The category (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getWorkspaceName

IWorkspaceName getWorkspaceName()
                                throws IOException,
                                       AutomationException

The WorkspaceName of the DatasetName.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setWorkspaceNameByRef

void setWorkspaceNameByRef(IWorkspaceName workspaceName)
                           throws IOException,
                                  AutomationException

The WorkspaceName of the DatasetName.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

workspaceName - A reference to a com.esri.arcgis.geodatabase.IWorkspaceName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSubsetNames

IEnumDatasetName getSubsetNames()
                                throws IOException,
                                       AutomationException

Subset names contained within this dataset name.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.