This document is archived and information here might be outdated.  Recommended version.


IGeometricNetworkConnectivity2.RebuildConnectivity2 Method (ArcObjects .NET 10.6 SDK)
ArcObjects Library Reference (GeoDatabase)  

IGeometricNetworkConnectivity2.RebuildConnectivity2 Method

Incrementally rebuilds connectivity for features within and intersecting the specified envelope. Version 2.

[Visual Basic .NET]
Public Sub RebuildConnectivity2 ( _
    ByVal incrementalRebuildArea As IEnvelope _
)
[C#]
public void RebuildConnectivity2 (
    IEnvelope incrementalRebuildArea
);
[C++]
HRESULT RebuildConnectivity2(
  IEnvelope* incrementalRebuildArea
);
[C++]

Parameters incrementalRebuildArea [in]
incrementalRebuildArea is a parameter of type IEnvelope*

Product Availability

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

Description

If network connectivity errors are found within the geometric network, they can generally be corrected through the use of the RebuildConnectivity2 method.  This method takes an envelope which should contain the network features for which connectivity will be rebuilt.  The RebuildConnectivity2 method does not check for invalid connectivity, it will remove and then rebuild the connectivity of any feature contained within or intersecting the specified envelope. 

RebuildConnectivity2 should only be used to rebuild the connectivity of features whose invalid geometry has been repaired or to rebuild inconsistent connectivity on features.  RebuildConnectivity2 is not as computationally expensive as IGeometricNetworkConnectivity::RebuildConnectivity and as such, can be used on a larger number of network features.  However, the size of the envelope supplied to RebuildConnectivity2 should still be taken into consideration.  It is generally faster to call RebuildConnectivity2 on small individual areas rather than one large area that encompasses the smaller areas.

RebuildConnectivity should not be used to establish connectivity between network features. To establish connectivity, use INetworkFeature::Connect.

Remarks

If RebuildConnectivity2 encounters an edge feature that is missing a junction on an endpoint, it will insert a new orphan junction at the endpoint of the edge feature.

See Also

IGeometricNetworkConnectivity2 Interface | IGeometricNetworkConnectivity.RebuildConnectivity Method | IGeometricNetworkConnectivity2.RebuildConnectivity2 Method