Provides access to members that manage metadata. Note: the IXmlPropertySet interface has been superseded byIXmlPropertySet2. Please consider using the more recent version.
Product Availability
Members
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. |
CoClasses that implement IXmlPropertySet
CoClasses and Classes | Description |
---|---|
XmlPropertySet | ESRI XML PropertySet object. |
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.