SolutionXMLElement property

Microsoft Visio Developer Reference

SolutionXMLElement property

   Example   

Contains solution-specific, well-formed XML data stored with a document.

Version added

2002

Syntax

xmlData = object.SolutionXMLElement (elementName)
object.SolutionXMLElement (elementName) = xmlValue

xmlData

String. The current XML data stored in elementName.

object

Required. An expression that returns a Document object.

elementName

Required String. The case-sensitive name of the SolutionXML data element.

xmlValue

Required String. The new valid, well-formed XML data to store in elementName.

Remarks

The value of elementName must match the value of the SolutionXML element's Name attribute. For example, if a solution's XML data began with the statement <SolutionXML Name='somename'>, use the elementName "somename" to retrieve that data.

  • If elementName already exists, the SolutionXMLElement property overwrites existing XML data. Use the SolutionXMLElementExists property before writing XML data to avoid losing data unintentionally.
  • If elementName does not exist, the SolutionXMLElement property creates an element by that name.

Because your XML data is validated when you write it, you will typically perform this operation during a document save event for performance reasons.