CreateElement(AssetType,Guid) Method

In This Topic

Creates an Element object, which represents a Row (or Row + Terminal) in a utility network. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public Element CreateElement( 
   AssetType assetType,
   Guid globalID
)

Public Overloads Function CreateElement( _
   ByVal assetType As AssetType, _
   ByVal globalID As Guid _
) As Element

Parameters

assetType: The AssetType of the row used to create the Element.
globalID: The global ID of the row used to create the Element.

Return Value

An Element object corresponding to from a NetworkSource associated with .

Exceptions

Exception	Description
System.ArgumentNullException	assetType is null.
ArcGIS.Core.Data.Exceptions.GeodatabaseException	A geodatabase-related exception has occurred.
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run

Remarks

No default Terminal is assigned. This overload allows the creation of a Element when no ArcGIS.Core.Data.Row is available. If you don't already have a Row object, fetching one requires an additional query (database query or round-trip call to the feature service). This constructor allows this extra call to be avoided.

Example

Create a utility network association

// Create edit operation
EditOperation editOperation = new EditOperation();
editOperation.Name = "Create structural attachment association";

// Create a RowHandle for the pole

Element poleElement = utilityNetwork.CreateElement(poleAssetType, poleGlobalID);
RowHandle poleRowHandle = new RowHandle(poleElement, utilityNetwork);

// Create a RowHandle for the transformer bank

Element transformerBankElement = utilityNetwork.CreateElement(transformerBankAssetType, transformerBankGlobalID);
RowHandle transformerBankRowHandle = new RowHandle(transformerBankElement, utilityNetwork);

// Attach the transformer bank to the pole

AssociationDescription structuralAttachmentAssociationDescription = new AssociationDescription(AssociationType.Attachment, poleRowHandle, transformerBankRowHandle);
editOperation.Create(structuralAttachmentAssociationDescription);
editOperation.Execute();

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3.0 or higher.

Reference

UtilityNetwork Class
UtilityNetwork Members
Overload List

Send feedback