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

C#
Visual Basic (Declaration)

public IReadOnlyList<long> Split( 
   Geometry splitGeometry
)

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

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

public 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, Windows 10

ArcGIS Pro version: 3.4 or higher.

Reference

Feature Class
Feature Members

Send feedback