Length Method (GeometryEngine)

In This Topic

Gets the length for a specified geometry. This is a planar measurement using 2D Cartesian mathematics.

Syntax

C#
Visual Basic (Declaration)

public double Length( 
   Geometry geometry
)

Public Function Length( _
   ByVal geometry As Geometry _
) As Double

Parameters

geometry: The input geometry.

Return Value

The calculated length in the same units as the geometry's spatial reference unit. If the geometry is empty, then zero is returned.

Exceptions

Exception	Description
System.ArgumentNullException	Geometry is null.
System.NotImplementedException	The method is not implemented for GeometryBag or Multipatch.

Example

Determine Length, Length3D of line

MapPoint c1 = MapPointBuilderEx.CreateMapPoint(1, 2, 3);
MapPoint c2 = MapPointBuilderEx.CreateMapPoint(4, 2, 4);

// line segment
LineSegment line = LineBuilderEx.CreateLineSegment(c1, c2);
double len = line.Length;     // = 3
double len3D = line.Length3D;   // = Math.Sqrt(10)

// polyline
Polyline p = PolylineBuilderEx.CreatePolyline(line);
double p_len = p.Length;        // = len = 3
double p_len3D = p.Length3D;    // = len3D = Math.Sqrt(10)

double ge_len = GeometryEngine.Instance.Length(p);      // = p_len = len = 3
double ge_len3d = GeometryEngine.Instance.Length3D(p);    // = p_len3D = len3D = Math.Sqrt(10)

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

GeometryEngine Class
GeometryEngine Members

Send feedback