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

Visual Basic (Declaration)
C#

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

public Element CreateElement( 
   AssetType assetType,
   Guid globalID
)

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

{
  // This routine creates a structural attachment association between a pole and a transformer bank
  static void CreateUNAssociation(UtilityNetwork utilityNetwork, AssetType poleAssetType, Guid poleGlobalID, AssetType transformerBankAssetType, Guid transformerBankGlobalID)
  {
    // 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 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

UtilityNetwork Class
UtilityNetwork Members
Overload List

Send feedback