Length Method (IGeometryEngine)

In This Topic

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

Syntax

Visual Basic (Declaration)
C#

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

double Length( 
   Geometry geometry
)

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 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

IGeometryEngine Interface
IGeometryEngine Members

Send feedback