Class wwXMLState

The wwXMLState class allows you to add and retrieve properties easily from an XML string with a couple of simple lines of code.

Example:


        foxpro
        
            
        
     

        foxpro
        
            
        
     
SET PROCEDURE TO wwXMLState

USE SomeTable

o = CREATEOBJECT("wwXMLState")

* **Set a value
o.LoadXML(SomeTable.XMLPropertiesMemo)
o.SetProperty("testproperty","new value","string","Testing")
REPLACE SomeTable.XMLPropertiesMemo with o.cXML

* **Retrieve a value
o.cXML = SomeTable.XMLPropertiesMemo
lcValue = o.GetProperty("testproperty")

The XML format for the property storage looks like this:


        xml
        
            
        
     

        xml
        
            
        
     
<properties>
   <Test type="string" description="Test Value">Test Value</Test>
   <Number type="float">123.33</Number>
   <Bool type="boolean">1</Bool><Bool2 type="boolean">0</Bool2>
   <date type="datetime">12/28/2000</date>
   <datetime type="datetime">12/28/2000 1:07:25 AM</datetime>
</properties>

Based on: Relation Stored in: wwXMLState

Remarks

Requires the MSXML 3.0 parser in order to work. Note: Version 4.x and later of the MSXML parser may not work correctly due to some changes with the XPATH default namespaces.

The oDOM property is loaded in the Init of the class, so if you want to avoid reloading this object for every use of this class you should persist this object.

Class Members

Member		Description
	GetProperty	Retrieves a property from the XML state store string stored in cXML. o.GetProperty(lcProperty)
	GetXML	Returns the content of the current XML property state as a string. This vaue contains XML with all the properties. THis method simply returns the content of cXML, which is updated by each… o.GetXML()
	LoadXML	Loads an XML string or loads an XML document from a URL or file. o.LoadXML(lcXML, llUrl)
	SaveXML	Saves the XML content to a file. Note that you can use LoadXML and SaveXML to directly load content into the XMLDOM and never indirectly use the cXML property for holding property content. o.SaveXML(lcFileName)
	SetProperty	Sets a property in the XML state store saved in the cXML property. o.SetProperty(lcProperty, lcValue, lcType, lcDescription)
	cRootNode	The name of the root node in the property storage XML. This will be the XML document root element. Default is: properties

Assembly: wwXmlState.prg