Alter Method (CircuitManager)

In This Topic

Updates a circuit row in the circuit table with the provided argument's values. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Sub Alter( _
   ByVal circuit As Circuit _
)

public void Alter( 
   Circuit circuit
)

Parameters

circuit: The circuit to update.

Exceptions

Exception	Description
System.ArgumentNullException	circuit is null.
System.InvalidOperationException	This operation cannot be invoked inside ArcGIS.Core.Data.Geodatabase.ApplyEdits or when an edit operation is in progress.
ArcGIS.Core.Data.Exceptions.GeodatabaseException	A geodatabase-related exception has occurred.

Example

Alter an existing circuit in the utility network

await QueuedTask.Run(() =>
{
  using (CircuitManager circuitManager = utilityNetwork.GetCircuitManager(telecomDomainNetwork))
  {
    // Get the existing circuit
    Circuit circuit = circuitManager.GetCircuits(new CircuitFilter(["circuitName"])).First();

    // Update circuit name
    circuit.SetName(circuitNames.First());

    // Update start and stop locations
    circuit.SetStartLocation(new CircuitLocation(startElement));
    circuit.SetStopLocation(new CircuitLocation(stopElement));

    // Clear existing subcircuits
    circuit.SetSubcircuits(new List<Subcircuit>());

    // Apply the changes
    circuitManager.Alter(circuit);
  }
});

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.7 or higher.

Reference

CircuitManager Class
CircuitManager Members

Send feedback