Split Method (Feature)

In This Topic

Splits a polyline or polygon into multiple parts from the provided split geometry location with a system-assigned object ID.

Syntax

Visual Basic (Declaration)
C#

Public Function Split( _
   ByVal splitGeometry As Geometry _
) As IReadOnlyList(Of Long)

public IReadOnlyList<long> Split( 
   Geometry splitGeometry
)

Parameters

splitGeometry: Location to split a polyline or polygon feature

Return Value

The ObjectIDs of newly created features from the split operation.

Exceptions

Exception	Description
ArcGIS.Core.Data.Exceptions.GeodatabaseException	A geodatabase-related exception has occurred.
System.ArgumentException	splitGeometry is invalid (e.g., a null value or an empty).

Remarks

A point feature can split a polyline.
A polyline can split a polygon.
A line or multipoint cannot split a line; similarly, a polygon cannot split a polygon.

Example

Split a feature by geometry

{
  // Must be called within QueuedTask.Run
  void SplitALineByPoint(FeatureClass lineFeatureClass, MapPoint xPoint)
  {
    using (RowCursor rowCursor =
           lineFeatureClass.Search(new QueryFilter() { ObjectIDs = new List<long>() { 1 } }))
    {
      if (rowCursor.MoveNext())
      {
        using (Feature feature = rowCursor.Current as Feature)
        {
          // ObjectIDs of newly created lines
          IReadOnlyList<long> splits = feature.Split(xPoint);
        }
      }
    }
  }
}

Requirements

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

ArcGIS Pro version: 3.4 or higher.

Reference

Feature Class
Feature Members

Send feedback