UtilityNetworkTraceTool

Use named trace configurations defined in a web map to perform connected trace operations and compare results.

Features

• Load networks and named trace configurations from a web map

• Support for templating

• (UWP, WPF) Identify starting point candidates, then use the inspection view to narrow the selection:

  

• (UWP, WPF) Run multiple trace scenarios, then use color and name to compare results:

  

• User-friendly warnings help avoid common mistakes, including specifying too many starting points or running the same trace configuration multiple times:

  Duplicated trace	Too few starting points	Extra starting points

Customization

The following properties enable customization (UWP, WPF only):

• ResultItemTemplate - override the display of results
• StartingPointItemTemplate - override the display of starting points
• TraceTypeItemTemplate - override the display of the trace configuration choices
• UtilityNetworkItemTemplate - override the display of the Utility Network choices

All platforms:

• Template - allows overriding the appearance of the entire control

The following properties enable customizing symbology:

• StartingPointSymbol
• ResultFillSymbol
• ResultLineSymbol
• ResultPointSymbol

Usage

The default template for this control is optimized for a panel or side-by-side presentation with a width of around 300 dip.

.NET MAUI:

<Grid xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013"
      ColumnDefinitions="*,300">
    <esri:MapView x:Name="MyMapView" />
    <esri:UtilityNetworkTraceTool GeoView="{x:Reference MyMapView}"
                                  Grid.Column="1" />
</Grid>

UWP/WinUI:

<Grid xmlns:esri="using:Esri.ArcGISRuntime.UI.Controls"
      xmlns:toolkit="using:Esri.ArcGISRuntime.Toolkit.UI.Controls">
    <Grid.ColumnDefinitions>
        <ColumnDefinition Width="*" />
        <ColumnDefinition Width="300" />
    </Grid.ColumnDefinitions>
    <esri:MapView x:Name="MyMapView" />
    <toolkit:UtilityNetworkTraceTool GeoView="{x:Bind MyMapView}"
                                     Grid.Column="1" />
</Grid>

WPF:

<Grid xmlns:esri="http://schemas.esri.com/arcgis/runtime/2013">
    <Grid.ColumnDefinitions>
        <ColumnDefinition Width="*" />
        <ColumnDefinition Width="300" />
    </Grid.ColumnDefinitions>
    <esri:MapView x:Name="MyMapView" />
    <esri:UtilityNetworkTraceTool GeoView="{Binding ElementName=MyMapView}"
                                  Grid.Column="1" />
</Grid>