com.esri.arcgis.geodatabase
Interface INetAttributesEdit

All Superinterfaces:

INetAttributes, Serializable

All Known Implementing Classes:

INetAttributesEditProxy, StreetNetwork, UtilityNetwork

public interface INetAttributesEdit
extends INetAttributes, Serializable

Provides access to members that modify the disabled state and weight values of individual elements in the network.

Remarks

You should only directly manipulate the value of a weight in a stand-alone logical network.

When To Use

Use the INetAttributesEdit interface when you want to change the disabled state of an element in your network or when you want to modify the value of a weight.

Disabling an element means setting its DisabledState to "True".

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 INetAttributesEdit interface on logical networks that have an associated geometric network. The logical network maintains its own weight values for the purpose of faster access. Directly manipulating the weight values or Disabled state of elements in a logical network with a corresponding geometric network, will cause the weight values from the feature to be out of sync with the weight values maintained by the logical network.

For geometric networks the weight value or Disabled state should only be edited on the feature and not on the logical network element. Use IRowBuffer::Value and IRow::Store to modify the value of a feature attribute.

Product Availability

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

See Also:

INetAttributesEdit, INetAttributes

Method Summary

void	setDisabledState(int eID, int elementType, boolean disableState) Sets the disabled state of the specified network element.
void	setWeightValue(int eID, int elementType, int weightInternalID, Object weightValue) Sets the weight value of the specified network element for the specified weight.

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

getDisabledState, getWeightValue

Method Detail

setDisabledState

void setDisabledState(int eID,
                      int elementType,
                      boolean disableState)
                      throws IOException,
                             AutomationException

Sets the disabled state of the specified network element.

Remarks

Disabling an element in the network is different than creating a barrier on a network element. A disabled element will have an effect when setting the flow direction on a network. Setting barriers on a network through the INetworkAnalysisExtBarriers interface only affects traces.

Only use this method on stand-alone logical networks. For geometric networks, use IRowBuffer::Value and IRow::Store to modify the value of the feature attribute.

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)

disableState - The disableState (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setWeightValue

void setWeightValue(int eID,
                    int elementType,
                    int weightInternalID,
                    Object weightValue)
                    throws IOException,
                           AutomationException

Sets the weight value of the specified network element for the specified weight.

Remarks

SetWeightValue will update the attribute value defined by the specified weight for the specified element. Use this method when you want to change the attribute setting a weight will use during tracing routines.

Only use this method on stand-alone logical networks. For geometric networks, use IRowBuffer::Value and IRow::Store to modify the value of the feature attribute.

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)

weightInternalID - The weightInternalID (in)

weightValue - A Variant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.