CreateMultipoint(IEnumerable<MapPoint>,SpatialReference) Method

Convenience method to quickly create a Multipoint instance.

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 set of points which will comprise the multipoint.
spatialReference: (Optional) The SpatialReference. The default value is null. If spatialReference is null, then the spatial reference will be inherited from points.

Return Value

A Multipoint.

Exceptions

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

Example

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

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

// Builder convenience methods don't need to run on the MCT.
Multipoint multiPoint = MultipointBuilder.CreateMultipoint(list);
int ptCount = multiPoint.PointCount;

// Builder constructors need to run on the MCT.
ArcGIS.Desktop.Framework.Threading.Tasks.QueuedTask.Run(() =>
{
  using (MultipointBuilder mpb = new MultipointBuilder(list))
  {
    // do something with the builder

    Multipoint mPt = mpb.ToGeometry();

    ptCount = mpb.PointCount;
  }
});

// or use the builderEx constructors = don't need to run on the MCT.
MultipointBuilderEx builderEx = new MultipointBuilderEx(list);
multiPoint = builderEx.ToGeometry() as Multipoint;
ptCount = builderEx.PointCount;

Requirements

Target Platforms: Windows 10, Windows 8.1

Reference

MultipointBuilder Class
MultipointBuilder Members
Overload List