CreateMultipoint(IEnumerable<MapPoint>,SpatialReference) Method

In This Topic

Convenience method to create an instance of the Multipoint class.

Syntax

C#
Visual Basic (Declaration)

public static Multipoint CreateMultipoint( 
   IEnumerable<MapPoint> points,
   SpatialReference spatialReference
)

Public Overloads Shared Function CreateMultipoint( _
   ByVal points As IEnumerable(Of MapPoint), _
   Optional ByVal spatialReference As SpatialReference _
) As Multipoint

Parameters

points: The points of the newly created multipoint.
spatialReference: (Optional) The SpatialReference. The default value is null. If spatialReference is null, then the spatial reference will be inherited from points which requires traversing through the enumeration of points. For improved performance, use CreateMultipoint(IEnumerable<MapPoint>,AttributeFlags,SpatialReference).

Return Value

A Multipoint.

Exceptions

Exception	Description
System.InvalidOperationException	Incompatible spatial references.
System.ArgumentNullException	points is null.

Remarks

The HasZ, HasM and HasID properties are inherited from which requires traversing through the enumeration of points. For improved performance, use CreateMultipoint(IEnumerable<MapPoint>,AttributeFlags,SpatialReference).

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.0 or higher.

Reference

MultipointBuilderEx Class
MultipointBuilderEx Members
Overload List

Send feedback