|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IName
Provides access to members that work with Name objects.
A Name object is a persistable software object that identifies and locates a geodatabase object such as a dataset or a workspace or a map object such as a layer.
A Name object supports an Open method that allows the client to get an instance of the actual object (for example, the dataset or workspace) given the name object. A name object thus acts as a moniker that supports binding to the named object.
The geodatabase supports methods on workspaces that hand out name objects that can be used by browsing clients to display the names of datasets in the workspace and to instantiate any specific dataset.
Name objects may also carry properties that describe the object being named. A browsing client to display additional information about the object being named can use these properties. A Name object may also support methods to access metadata for or methods to change permissions on the actual object. In these cases, a name object can be used as a lightweight surrogate of the actual object until such time as further properties of the object are needed or additional methods on the object need to be called.
Name objects are cocreatable and can also be used to specify datasets that are yet to be created, for example the output dataset to be created by a geoprocessing operation. There are several kinds of name objects, for example workspace, table, feature class, feature dataset, raster and relationship class name objects.
Name objects may be persisted (serialized) using the IPersistStream interface. Name objects are the mechanism used to save references to the datasets corresponding to the layers in a map, when the map is saved as a map document.
Method Summary | |
---|---|
String |
getNameString()
The name string of the object. |
Object |
open()
Opens the object referred to by this name. |
void |
setNameString(String nameString)
The name string of the object. |
Method Detail |
---|
void setNameString(String nameString) throws IOException, AutomationException
The NameString property is reserved for future use. When implemented, it will return a string representation of the locational component of the name object that may be persisted by applications.
nameString
- The nameString (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.String getNameString() throws IOException, AutomationException
The NameString property is reserved for future use. When implemented, it will return a string representation of the locational component of the name object that may be persisted by applications.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.Object open() throws IOException, AutomationException
The Open method lets you instantiate the actual object given the name object.
Note: Opening a feature class that participates in a topology or geometric network will also open all other feature classes participating in the topology or geometric network in memory.
IName pName = pFeatureClassName;
pFeatureClass = new IFeatureClassProxy(pName.open());
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |