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.

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.

As of the 10.0 release; the CreateNetwork method is no longer supported on Logical Networks that is not associated with a geometric network.

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.

As of the 10.0 release; the OpenNetwork method is no longer supported on Logical Networks that are associated with a Geometric Network.

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.

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.