SetMetadata Method (Map)

In This Topic

Sets the Map metadata. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

C#
Visual Basic (Declaration)

public void SetMetadata( 
   string metadataXml
)

Public Sub SetMetadata( _
   ByVal metadataXml As String _
)

Parameters

metadataXml: The xml formatted metadata

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run.
System.Xml.XmlException	There is a load or parse error in the XML

Remarks

The input xml must be a valid metadata document and, as a minimum, have a root <metadata> element. The Map metadata must be editable. Refer to GetCanEditMetadata.

Example

Get and Set Map Metadata

var map = MapView.Active.Map;
if (map == null) return;
//Get map's metadata
var mapMetadata = map.GetMetadata();
//TODO:Make edits to metadata using the retrieved mapMetadata string.

//Set the modified metadata back to the map.
if (map.GetCanEditMetadata())
  map.SetMetadata(mapMetadata);

Requirements

Target Platforms: Windows 11, Windows 10, Windows 8.1

Reference

Map Class
Map Members

Send feedback