FromXml Method (EnvelopeBuilderEx)

In This Topic

Creates a new instance of the Envelope class from an ArcGIS XML string representation.

Syntax

C#
Visual Basic (Declaration)

public static Envelope FromXml( 
   string xmlString
)

Public Shared Function FromXml( _
   ByVal xmlString As String _
) As Envelope

Parameters

xmlString: XML representation of an envelope.

Return Value

An Envelope

Exceptions

Exception	Description
System.ArgumentNullException	The xmlString is empty or null.
ArcGIS.Core.Geometry.Exceptions.GeometryObjectException	XML is invalid or does not represent an Envelope string.

Example

Import and Export Geometries to XML

MapPoint minPoint = MapPointBuilderEx.CreateMapPoint(1, 1, 1, 1, 3);
MapPoint maxPoint = MapPointBuilderEx.CreateMapPoint(5, 5, 5);

// 
//  MapPoint
// 
string xml = minPoint.ToXml();
MapPoint minPointImport = MapPointBuilderEx.FromXml(xml);
// minPointImport = minPoint

//
// Envelope
//
Envelope envelopeWithID = EnvelopeBuilderEx.CreateEnvelope(minPoint, maxPoint);

// Envelopes don't have IDs
// envelopeWithID.HasID = false
// envelopeWithID.HasM = true
// envelopeWithID.HasZ = true

xml = envelopeWithID.ToXml();
Envelope envelopeImport = EnvelopeBuilderEx.FromXml(xml);

//
// Multipoint
//
List<MapPoint> list = new List<MapPoint>();
list.Add(minPoint);
list.Add(maxPoint);

Multipoint multiPoint = MultipointBuilderEx.CreateMultipoint(list);

xml = multiPoint.ToXml();
Multipoint multipointImport = MultipointBuilderEx.FromXml(xml);
// multipointImport.PointCount == 2
// multipointImport.HasID = true
// multipointImport.HasM = true
// multipointImport.HasZ= true

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

EnvelopeBuilderEx Class
EnvelopeBuilderEx Members

Send feedback