ArcObjects Library Reference (GeoDatabase)  

INetworkEvaluatorSetup.Initialize Method

Initializes the network evaluator in preparation to evaluate the attribute value of a network element.

[Visual Basic .NET]
Public Sub Initialize ( _
    ByVal NetworkDataset As INetworkDataset, _
    ByVal DataElement As IDENetworkDataset, _
    ByVal Source As INetworkSource, _
    ByVal Attribute As IEvaluatedNetworkAttribute _
)
[C#]
public void Initialize (
    INetworkDataset NetworkDataset,
    IDENetworkDataset DataElement,
    INetworkSource Source,
    IEvaluatedNetworkAttribute Attribute
);
[C++]
HRESULT Initialize(
  INetworkDataset* NetworkDataset,
  IDENetworkDataset* DataElement,
  INetworkSource* Source,
  IEvaluatedNetworkAttribute* Attribute
);
[C++]

Parameters

NetworkDataset [in]

  NetworkDataset is a parameter of type INetworkDataset

DataElement [in]

  DataElement is a parameter of type IDENetworkDataset

Source [in]

  Source is a parameter of type INetworkSource

Attribute [in]

  Attribute is a parameter of type IEvaluatedNetworkAttribute

Product Availability

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

Remarks

The Initialize method does all the "heavy lifting" needed to prepare the evaluator for a call to QueryValue, a lightweight method for querying the attribute value for a network element.  Once the evaluator is initialized, the client can make multiple calls to this lightweight QueryValue for calculating the attribute values of multiple network elements.

When querying for attribute values in the network dataset ArcGIS calls the Initialize method immediately after it instantiates the evaluator.  For evaluators with CacheAttribute = True, this occurs when building the network dataset.  For evaluators with CacheAttribute = False, this occurs on the first call in the session to INetworkElement::AttributeValue or ::AttributeValueByName that requires this evaluator to determine the attribute value.

See Also

INetworkEvaluatorSetup Interface