IXmlPropertySet Interface

Provides access to members that manage metadata. Note: the IXmlPropertySet interface has been superseded by IXmlPropertySet2. Please consider using the more recent version.

Product Availability

Members

	Name	Description
	CountX	Number of occurrances of an element in the metadata.
	DeleteProperty	Deletes the specified elements.
	DeletePropertyByAttribute	Deletes the elements which have the specified attribute value.
	GetPropertiesByAttribute	Returns the set of names and values for elements which have the specified attribute value.
	InitExisting	Initializes an XmlPropertySet and adds the Esri group of elements.
	IsNew	Indicates if a new XmlPropertySet was created on retrieving the metadata.
	SaveAsFile	Transforms the metadata using an XSL stylesheet if specified, writes out the header if specified, and saves it in a file.
	SetAttribute	Sets the attribute of the specified element.
	SetPropertyX	Sets the value of the specified element.
	SimpleGetProperty	The values of the specified property.
	TransformImages	Transforms encoded thumbnail and image enclosures to files and links them into the metadata.

Classes that implement IXmlPropertySet

Remarks

This interface uses XPath, a way to select a node or groups of nodes that match a selection criteria, as parameters in several methods and properties (CountX property, DeleteProperty method, SetAttribute method, SetPropertyX method, and SimpleGetProperty method).  XPath provides a simple query language for identifying nodes in an XML document based on attribute, name, and values. 

An important point when using XPath is that the names of properties and attributes, as well as the values of both, are case sensitive. Also, because metadata always has a <metadata> root node, it can be omitted from patterns used with this interface. For example, "/metadata/node/subnode" should just be "node/subnode".

Some basic examples of XPath include:

• node: Finds all node elements.
• parent/child: Finds all child elements within parent elements.
• parent/*: Finds all elements within parent elements.
• parent[child = "val1"]: Finds all parent elements with a child element that has a value of "val1".
• node[@Sync]: Finds all node elements with a Sync attribute.
• node[@Sync = "TRUE"]: Finds all node elements with a Sync attribute that has a value of "TRUE".
• node[@Sync != "TRUE"]: Finds all node elements with a Sync attribute that has a value other than "TRUE".
• desc[. = "myDesc"]: Finds all desc elements that have a value of "myDesc".
• attr[5]: Finds the 6th attr element (the indexer is zero-based).

For more examples of XPath, see the MSDN article, XPath Examples.

When using this interface on a newly-created XmlPropertySet, the property set should be cast to the IXmlPropertySet2 interface and the InitGeneric method should be called. See the XmlPropertySet coclass documentation for more information.