com.esri.arcgis.geodatabase
Interface ITopologyWorkspace

All Superinterfaces:

Serializable

All Known Implementing Classes:

ITopologyWorkspaceProxy, Sde4Workspace, Workspace

public interface ITopologyWorkspace
extends Serializable

Provides access to members that access the topologies in a workspace.

Remarks

The ITopologyWorkspace interface provides access to the OpenTopology method that allows you open a topology within a workspace given only the topology’s name. Use this interface to open a topology when you only have a reference to a workspace object. For ArcSDE Geodatabases, the fully qualified name can be used to return topologies owned by specific users. If multiple topologies with the same name are owned by different users, OpenTopology will return the topology owned by the current user if an unqualified name is supplied.

Product Availability

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

Method Summary

ITopology

openTopology(String name) Opens and returns the topology with the specified name.

Method Detail

openTopology

ITopology openTopology(String name)
                       throws IOException,
                              AutomationException

Opens and returns the topology with the specified name.

Remarks

The OpenTopology method can be used to open any existing topology in the workspace given its fully qualified name. Note that every topology in a geodatabase has a unique fully qualified name. Use the IDatabaseConnectionInfo interface to determine the User and Database (if applicable). ISQLSyntax::QualifyTableName can be used to determine the fully qualified name for a topology. Use the IWorkspace2::NameExists method to determine if a topology with the appropriate name exists in the geodatabase.

Some examples of how to use the name parameter of OpenTopology are shown below:

For topologies in a Personal or File Geodatabase:
MyTopology

For topologies in an Oracle ArcSDE Geodatabase (the owner prefix is unnecessary if you are connected as the owner of the topology):
gdb.MyTopology

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

name - The name (in)

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.