ArcGIS Pro 3.4 API Reference Guide
ArcGIS.Core.Data.UtilityNetwork.Trace Namespace / TraceArgument Class / TraceArgument Constructor / TraceArgument Constructor(IEnumerable<Element>)
A set of starting locations from which to originate the trace.
Example Version

TraceArgument Constructor(IEnumerable<Element>)
Initializes a new instance of the TraceArgument class using startingLocations.
Syntax

Parameters

startingLocations
A set of starting locations from which to originate the trace.
Exceptions
Example
Create a Trace Argument
IReadOnlyList<Element> startingPointList = new List<Element>();

// Code to fill in list of starting points goes here...
TraceArgument traceArgument = new TraceArgument(startingPointList);

TraceConfiguration traceConfiguration = new TraceConfiguration();

// Code to fill in trace configuration goes here...
traceArgument.Configuration = traceConfiguration;
Trace a utility network with the digitized direction
private void TraceWithDigitizedDirection(UtilityNetwork utilityNetwork, Element startElement)
{
  using TraceManager traceManager = utilityNetwork.GetTraceManager();

  // Trace configuration with digitized direction 
  TraceConfiguration traceConfiguration = new TraceConfiguration()
  {
    IncludeIsolatedFeatures = true,
    IncludeBarriersWithResults = true,
    UseDigitizedDirection = true
  };

  // Trace argument
  List<Element> startElements = new List<Element> { startElement };

  TraceArgument traceArgument = new TraceArgument(startElements);
  traceArgument.Configuration = traceConfiguration;

  // Results
  DownstreamTracer downstreamTracer = traceManager.GetTracer<DownstreamTracer>();

  IReadOnlyList<Result> traceResults = downstreamTracer.Trace(traceArgument);
  foreach (Result traceResult in traceResults)
  {
    // Iterate trace results
  }
}
Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.
See Also