ArcGIS Pro 3.2 API Reference Guide
ArcGIS.Core.Data.UtilityNetwork.Trace Namespace / Tracer Class / Trace Method / Trace(TraceArgument) Method
The input arguments to the trace.
Example Version

Trace(TraceArgument) Method
Executes a trace.
Syntax

Parameters

traceArgument
The input arguments to the trace.

Return Value

A IReadOnlyList of concrete Result whose type corresponds to ResultType set in TraceArgument.ResultTypes.
Exceptions
Remarks
Derived implementations may impose stronger preconditions. For example, a concrete Tracer implementation may throw a System.ArgumentException if traceArgument is created using the TraceArgument.TraceArgument Constructor(Subnetwork) constructor when ArcGIS.Core.Data.UtilityNetwork.Subnetwork does not apply to the particular tracer.
Example
Trace a utility network using a named trace configuration
private void TraceUtilityNetworkUsingNamedTraceConfiguration(UtilityNetwork utilityNetwork, NamedTraceConfiguration namedTraceConfiguration, Element startElement)
{
  // Get the trace manager from the utility network
  using (TraceManager traceManager = utilityNetwork.GetTraceManager())
  {
    // Get a tracer from the trace manager using the named trace configuration
    Tracer upstreamTracer = traceManager.GetTracer(namedTraceConfiguration);

    // Trace argument holding the trace input parameters
    TraceArgument upstreamTraceArgument = new TraceArgument(namedTraceConfiguration, new List<Element> { startElement });

    // Trace results 
    IReadOnlyList<Result> upstreamTraceResults = upstreamTracer.Trace(upstreamTraceArgument);
  }
}
Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3.2 or higher.
See Also