Class GeometryBuilder<T>

Builder for creating and modifying geometries incrementally.

Inheritance

System.Object

GeometryBuilder<T>

System.Object.ToString()

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

Namespace: Esri.ArcGISRuntime.Geometry

Assembly: Esri.ArcGISRuntime.dll

Syntax

public abstract class GeometryBuilder<T>
    where T : Geometry

Type Parameters

Name	Description
T	Geometry type

Remarks

This is the base class for a range of geometry builders, such as a MapPointBuilder, PolylineBuilder and PolygonBuilder. Each GeometryType has a corresponding type of builder. You can create and modify polygons with PolygonBuilder, envelopes with EnvelopeBuilder, and so on. Use a geometry builder in editing workflows where you need to build up or edit geometry one vertex at a time, for example, when you need to add or edit a vertex from a custom streaming GIS data source. You can either create an empty geometry builder and build up the shape of a Geometry, or you can create a geometry builder with an existing Geometry and modify it.

When you construct the builder, you can explicitly set its or you can construct the builder with a geometry and the builder will adopt the SpatialReference. Once set, the cannot be changed. The SpatialReference of any geometry or coordinates added to the builder must be compatible with the SpatialReference of the builder, as they will not be reprojected. The SpatialReference of a geometry added to the builder can be null, in which case the object is assumed to have the same SpatialReference as the builder it is added to.

There are other ways to create and edit geometries. If you know all the geometry coordinates up front, then you can use geometry constructors, such as Polygon, to create the geometry. If you are going to create a new geometry as a result of a topological operation, such as the buffer operation, then explore the GeometryEngine. If you want your app users to interactively create or edit geometries in the user interface then use the GeometryEditor.

Properties

Name	Description
Extent	Gets the extent for the geometry in the builder.
HasCurves	Gets a value indicating whether the geometry builder currently contains any curve segments.
HasM	Gets a value indicating whether the geometry builder supports geometries with m values.
HasZ	Gets a value indicating whether the geometry builder supports geometries with z values.
IsEmpty	Gets a value indicating whether the geometry builder is empty or not.
IsSketchValid	Gets a value indicating whether this builder contains sufficient points to show a valid graphical sketch.
SpatialReference	Gets the SpatialReference for the geometry being built.

Methods

Name	Description
ReplaceGeometry(T)	Replace the geometry currently stored in the geometry builder to the new geometry.
ToGeometry()	Returns the Geometry this geometry builder is constructing or modifying.

Applies to

Target	Versions
.NET Standard 2.0	100.3 - 200.5
.NET	100.13 - 200.5
.NET Windows	100.13 - 200.5
.NET Android	200.0 - 200.5
.NET iOS	200.0 - 200.5
.NET Framework	100.0 - 200.5
Xamarin.Android	100.0 - 100.15
Xamarin.iOS	100.0 - 100.15
UWP	100.0 - 200.5