Interface ITopologyWorkspace

All Superinterfaces:
All Known Implementing Classes:
ITopologyWorkspaceProxy, Sde4Workspace, Workspace

public interface ITopologyWorkspace
extends Serializable

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


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


ITopology openTopology(String name)
                       throws IOException,
Opens and returns the topology with the specified name.


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:
For topologies in an Oracle ArcSDE Geodatabase (the owner prefix is unnecessary if you are connected as the owner of the topology):

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

name - The name (in)
A reference to a com.esri.arcgis.geodatabase.ITopology
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.