MultipointBuilderEx Constructor(IEnumerable<MapPoint>,AttributeFlags,SpatialReference)

In This Topic

Creates a new instance of the MultipointBuilderEx class.

Syntax

C#
Visual Basic (Declaration)

public MultipointBuilderEx( 
   IEnumerable<MapPoint> mapPoints,
   AttributeFlags attributes,
   SpatialReference spatialReference
)

Public Function New( _
   ByVal mapPoints As IEnumerable(Of MapPoint), _
   ByVal attributes As AttributeFlags, _
   Optional ByVal spatialReference As SpatialReference _
)

Parameters

mapPoints: The enumeration of points which will initialize the builder. It cannot be null.
attributes: AttributeFlags to set the HasZ, HasM and HasID properties. If no attributes should be set, pass AttributeFlags.None. If all attributes should be set, pass AttributeFlags.AllAttributes. Use the bitwise OR operator to set two attributes. For example, to set HasZ = true and HasM = true, pass AttributeFlags.HasZ | AttributeFlags.HasM.
spatialReference: (Optional) The spatial reference. The default value is null.

Exceptions

Exception	Description
System.ArgumentNullException	The input mapPoints enumeration is null.

Example

Construct a Multipoint - from an enumeration of MapPoints

// Use a builderEx convenience method or use a builderEx constructor.

List<MapPoint> list = new List<MapPoint>();
list.Add(MapPointBuilderEx.CreateMapPoint(1.0, 1.0));
list.Add(MapPointBuilderEx.CreateMapPoint(1.0, 2.0));
list.Add(MapPointBuilderEx.CreateMapPoint(2.0, 2.0));
list.Add(MapPointBuilderEx.CreateMapPoint(2.0, 1.0));

// use the builderEx constructors which don't need to run on the MCT.
// use AttributeFlags.NoAttributes since we have 2d points in the list
MultipointBuilderEx builderEx = new MultipointBuilderEx(list, AttributeFlags.None);
Multipoint multiPoint = builderEx.ToGeometry() as Multipoint;
int ptCount = builderEx.PointCount;

// builderEx convenience methods don't need to run on the MCT
multiPoint = MultipointBuilderEx.CreateMultipoint(list);
// multiPoint.HasZ, HasM, HasID will be false - the attributes are determined 
//    based on the attribute state of the points in the list

// or specifically set the state
multiPoint = MultipointBuilderEx.CreateMultipoint(list, AttributeFlags.None);
// multiPoint.HasM = false

multiPoint = MultipointBuilderEx.CreateMultipoint(list, AttributeFlags.HasM);
// multiPoint.HasM = true

ptCount = multiPoint.PointCount;

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

MultipointBuilderEx Class
MultipointBuilderEx Members
Overload List

Send feedback