ArcGIS Pro 3.3 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

In This Topic
    TraceArgument Constructor(IEnumerable<Element>)
    In This Topic
    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