com.esri.arcgis.geodatabase
Interface INetworkFeature

All Superinterfaces:

Serializable

All Known Implementing Classes:

ComplexEdgeFeature, ComplexJunctionFeature, SimpleEdgeFeature, SimpleJunctionFeature

public interface INetworkFeature
extends Serializable

Provides access to members that are common to all features in a GeometricNetwork.

Remarks

Features in a network can have one of four roles:

Simple Edge
Simple Junction
Complex Edge
Complex Junction

When To Use

Use the INetworkFeature interface to retrieve properties of a network feature.

Product Availability

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

See Also:

IComplexNetworkFeature, IJunctionFeature, INetworkFeature.connect(), IEdgeFeature, IComplexJunctionFeature, IComplexEdgeFeature, INetworkFeatureEvents, ISimpleJunctionFeature, ISimpleEdgeFeature, INetworkFeature

Method Summary

void	connect() Connect the Feature to the geometrically coincident NetworkFeature.
IEnumNetEID	createNetworkElements() Create the necessary NetworkElements in the associated Logical Network.
void	disconnect() Disconnect the Feature from all connected NetworkFeatures.
IGeometricNetwork	getGeometricNetwork() The containing GeometricNetwork.
boolean	isEnabled() Indicates whether the NetworkFeature is open or not (i.e., closed).
void	onDisconnect() Preparation for disconnecting the NetworkFeature.
void	setEnabled(boolean isEnabled) Indicates whether the NetworkFeature is open or not (i.e., closed).

Method Detail

getGeometricNetwork

IGeometricNetwork getGeometricNetwork()
                                      throws IOException,
                                             AutomationException

The containing GeometricNetwork.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isEnabled

boolean isEnabled()
                  throws IOException,
                         AutomationException

Indicates whether the NetworkFeature is open or not (i.e., closed).

Remarks

The Enabled property provides access the enabled state of network features. The enabled state of network feature governs whether the feature is enabled or disabled for tracing. By default, all network features are enabled when the network is built or when first created.

All edits to features that participate in a Geometric Network must be performed within an edit session and bracketed within an edit operation.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The isEnabled

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setEnabled

void setEnabled(boolean isEnabled)
                throws IOException,
                       AutomationException

Indicates whether the NetworkFeature is open or not (i.e., closed).

Example:

//Assume you already have a reference to IFeature called pFeature
INetworkFeature pNetworkFeature = pFeature;

if(pNetworkFeature != null){

  if(pNetworkFeature.isEnabled )
    pNetworkFeature.setEnabled (false);
  else
    pNetworkFeature.setEnabled (true);
}
  pFeature.store();

 

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

isEnabled - The isEnabled (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

connect

void connect()
             throws IOException,
                    AutomationException

Connect the Feature to the geometrically coincident NetworkFeature.

Remarks

All edits to features that participate in a Geometric Network must be performed within an edit session and bracketed within an edit operation.

Looping through a collection or enumeration of junctions and calling Connect on each one to establish connectivity with a complex edge feature is an expensive operation. Calling IComplexEdgeFeature::ConnectatIntermediateVertices once on the complex edge feature will result in increased performance with the same resultant connectivity.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

See Also:

IComplexEdgeFeature.connectAtIntermediateVertices()

disconnect

void disconnect()
                throws IOException,
                       AutomationException

Disconnect the Feature from all connected NetworkFeatures.

Remarks

All edits to features that participate in a Geometric Network must be performed within an edit session and bracketed within an edit operation.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

onDisconnect

void onDisconnect()
                  throws IOException,
                         AutomationException

Preparation for disconnecting the NetworkFeature.

Remarks

OnDisconnect is not currently implemented.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createNetworkElements

IEnumNetEID createNetworkElements()
                                  throws IOException,
                                         AutomationException

Create the necessary NetworkElements in the associated Logical Network.

Remarks

Every network feature in a geometric network has a corresponding network element in the logical network. CreateNetworkElements is called by the geometric network when network features are created. It is not neccessary for developers to call this method after creating new network features.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.