FromXml Method (EnvelopeBuilderEx)

In This Topic

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

Syntax

Visual Basic (Declaration)
C#

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

public static Envelope FromXml( 
   string xmlString
)

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 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

EnvelopeBuilderEx Class
EnvelopeBuilderEx Members

Send feedback