com.esri.arcgis.geodatabase
Interface INetworkWorkspace

All Superinterfaces:
Serializable
All Known Subinterfaces:
INetworkWorkspace2
All Known Implementing Classes:
INetworkWorkspace2Proxy, INetworkWorkspaceProxy, NetworkWorkspace, Sde4Workspace

public interface INetworkWorkspace
extends Serializable

Provides access to members that create and maintain information about logical networks.

Superseded By

INetworkWorkspace2

Remarks

The INetworkWorkspace interface is used for creating and opening a logical network that does not have a corresponding geometric network. This may be necessary to model relationships that do not have a spatial representation. To create a geometric network from existing feature classes use the INetworkLoader interface on the NetworkLoader object.

When To Use

Use the INetworkWorkspace interface to open and create a logical network that does not have an associated geometric network.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

See Also:
INetworkUpdate, IForwardStar, IGraph, INetworkClass.getNetworkAncillaryRole(), INetworkWorkspace, INetworkClass.getGeometricNetwork(), INetworkClass.getFieldToWeightMapping(int), IUtilityNetwork, INetwork

Method Summary
 INetwork createNetwork(String networkName, int networkType, boolean buildNormalizedTables)
          Creates a logical network.
 IEnumBSTR getNetworkNames()
          Returns an enumeration of the names of the logical networks within the current workspace.
 INetwork openNetwork(String networkName, int networkType, int networkAccess)
          Opens a logical network.
 

Method Detail

createNetwork

INetwork createNetwork(String networkName,
                       int networkType,
                       boolean buildNormalizedTables)
                       throws IOException,
                              AutomationException
Creates a logical network.

Remarks

CreateNetwork should be used to create a logical network that is not associated with a geometric network. If you want to create a geometric network that with it's associated logical network, use:
INetworkCollection::CreateGeometricNetwork
INetworkCollection2::CreateGeometricNetworkEx
INetworkLoader
Use INetworkWorkspace2::CreateNetworkEx to create a stand-alone logical network based on a configuration keyword.
The connectivity for the logical network is stored in a series of tables in the database. The actual connectivity is managed in a series of BLOBs.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
networkName - The networkName (in)
networkType - A com.esri.arcgis.geodatabase.esriNetworkType constant (in)
buildNormalizedTables - The buildNormalizedTables (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.INetwork
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

openNetwork

INetwork openNetwork(String networkName,
                     int networkType,
                     int networkAccess)
                     throws IOException,
                            AutomationException
Opens a logical network.

Remarks

The OpenNetwork method should only be used to open a logical network that does not have any corresponding geometric network. Opening a logical network with a corresponding geometric network for the purposes of updating network elements, can lead to inconsistencies between the logical and geometric networks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
networkName - The networkName (in)
networkType - A com.esri.arcgis.geodatabase.esriNetworkType constant (in)
networkAccess - A com.esri.arcgis.geodatabase.esriNetworkAccess constant (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.INetwork
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getNetworkNames

IEnumBSTR getNetworkNames()
                          throws IOException,
                                 AutomationException
Returns an enumeration of the names of the logical networks within the current workspace.

Remarks

This method is not available in VisualBasic.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.system.IEnumBSTR
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.