com.esri.arcgis.geodatabase
Interface INetTopologyEdit

All Superinterfaces:

INetTopology, Serializable

All Known Implementing Classes:

INetTopologyEditProxy, StreetNetwork, UtilityNetwork

public interface INetTopologyEdit
extends INetTopology, Serializable

Provides access to members that add and delete network elements from the logical network.

When To Use

Use the INetTopologyEdit interface to add and delete elements from a logical network.

This interface is designed specifically for the editing of a stand-alone logical network, a logical network that does not have an associated geometric network. It is imperative that if you have a geometric network, the logical network must be edited through its associated geometric network. You risk data corruption if you use the INetTopologyEdit interface on logical networks that have an associated geometric network. When a feature is created or removed in the geometric network, the corresponding element in the logical network is added or deleted as well.

The logical network maintains its own topology for the purpose of faster access. Directly manipulating the logical network's topology will cause the features in the geometric network to be out of sync with the topology maintained by the logical network.

Product Availability

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

See Also:

INetTopologyEdit,

Not all members are callable from Java. Please use INetTopologyEditGEN instead.

Method Summary

int	addEdgeByEndEIDs(INetElementDescription edgeDescription, int fromJunctionEID, int toJunctionEID) Adds an edge element to the logical network between the specified junction elements.
int	addJunction(INetElementDescription junctionDescription) Adds a junction element to the logical network.
void	deleteByEID(int eID, int elementType) Deletes the specified network element from the logical network.
void	deleteByEIDs(int elementType, int elementCount, int[] elementEIDs) Deletes the specified network elements from the logical network.
void	deleteByID(int userClassID, int userID, int userSubID, int elementType) Deletes the specified network element from the logical network.

Methods inherited from interface com.esri.arcgis.geodatabase.INetTopology

getAdjacentEdge, getAdjacentEdgeCount, getAdjacentEdges, getFromToJunctionEIDs

Method Detail

addJunction

int addJunction(INetElementDescription junctionDescription)
                throws IOException,
                       AutomationException

Adds a junction element to the logical network.

Remarks

The value returned by AddJunction is the Element ID (EID) for the newly created junction. This value is unique.

Unlike edges, a junction can exist in a logical network without attachment to any edges. When a junction exits in this state (once it has been created using this function call), it is not connected to any other portion of the network, but may have edges connected to it so that it will be part of the network.

Only use this method on stand-alone logical networks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

junctionDescription - A reference to a com.esri.arcgis.geodatabase.INetElementDescription (in)

Returns:

The junctionEID

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addEdgeByEndEIDs

int addEdgeByEndEIDs(INetElementDescription edgeDescription,
                     int fromJunctionEID,
                     int toJunctionEID)
                     throws IOException,
                            AutomationException

Adds an edge element to the logical network between the specified junction elements.

Remarks

AddEdgeByEndEIDs adds a new edge between the specified junctions. The value returned by AddEdgeByEndEIDs is the Element ID (EID) for the newly created edge. This value is unique.

Define the parameters of the edge to add in the INetElementDescription object that you pass in.

Only use this method on stand-alone logical networks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

edgeDescription - A reference to a com.esri.arcgis.geodatabase.INetElementDescription (in)

fromJunctionEID - The fromJunctionEID (in)

toJunctionEID - The toJunctionEID (in)

Returns:

The edgeEID

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

deleteByID

void deleteByID(int userClassID,
                int userID,
                int userSubID,
                int elementType)
                throws IOException,
                       AutomationException

Deletes the specified network element from the logical network.

Remarks

DeleteByID removes the specified feature from the network. Only use this method to remove elements from stand-alone logical networks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

userClassID - The userClassID (in)

userID - The userID (in)

userSubID - The userSubID (in)

elementType - A com.esri.arcgis.geodatabase.esriElementType constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

deleteByEID

void deleteByEID(int eID,
                 int elementType)
                 throws IOException,
                        AutomationException

Deletes the specified network element from the logical network.

Remarks

DeleteByEID removes the specified element from the network. Only use this method on a stand-alone logical network.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

eID - The eID (in)

elementType - A com.esri.arcgis.geodatabase.esriElementType constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

deleteByEIDs

void deleteByEIDs(int elementType,
                  int elementCount,
                  int[] elementEIDs)
                  throws IOException,
                         AutomationException

Deletes the specified network elements from the logical network.

Remarks

DeleteByEIDs removes the specified array of elements from the network.

Only use this method on stand-alone logical networks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

This method is not callable from Java. Please use INetTopologyEditGEN::DeleteByEIDs.

Parameters:

elementType - A com.esri.arcgis.geodatabase.esriElementType constant (in)

elementCount - The elementCount (in)

elementEIDs - The elementEIDs (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.