XMLDocument Property

DHTML, HTML, & CSS

XMLDocument Property


Retrieves a reference to the XML Document Object Model (DOM) exposed by the object.

Syntax

HTMLN/A
Scripting[ oXMLObject = ] oObject.XMLDocument

Possible Values

oXMLObjectObject that specifies the XML DOM exposed by the object.

The property is read-only with no default value.

Remarks

For a complete description of the XML DOM exposed by the XMLDocument property, see the xml dom referenceInternet Link.

When persistence is applied to an element, a root node is automatically created within the exposed XML document. This node is accessed through the documentelementInternet Link property. You can use setattributeInternet Link to add attributes to the root node, and you can use appendchildInternet Link to add child nodes to the root node.

The XMLDocument property is available to the saveFavorite and saveHistory behaviors only when the onload and onsave events are fired.

Example

This example shows how a persistent object can access the XML DOM through the XMLDocument property. The setAttribute method is exposed through the XML DOM. The setAttribute method is not the same as the DHTML and persistence methods of the same name.

Sample Code

The setAttribute method is exposed through the XML DOM. It is a different method than the DHTML and persistence methods of the same name.

<HTML>
<HEAD>
<META NAME="save" CONTENT="history">
<STYLE>
   .saveHistory {behavior:url(#default#savehistory);}
</STYLE>
<SCRIPT>
function fnSave(){
   var oXMLDoc=oPersistObject.XMLDocument;
   var oNode=oXMLDoc.createNode(1,"Trunk", "");
   oNode.text="A tree trunk.";
   oNode.setAttribute("desc",oPersistObject.innerHTML);
   oXMLDoc.documentElement.insertBefore(oNode, null);
}
function fnLoad(){
   var oXMLDoc=oPersistObject.XMLDocument;
   var oItem=oXMLDoc.documentElement.childNodes.item(1);
   oPersistObject.innerHTML=oItem.getAttribute("desc");
}
function fnInsTxt(){
   oPersistObject.innerHTML="I am an Ash.  I am an Ash sapling."
      + "Well, I am the trunk of an Ash sapling.";
}
</SCRIPT>
</HEAD>
<BODY>
<INPUT TYPE="button" VALUE="Insert Text" ONCLICK="fnInsTxt()">
<A HREF="/workshop/samples/author/persistence/saveTarget_1.htm">
   Leave The Page
</A>
<DIV
   ID="oPersistObject"
   CLASS="saveHistory"
   ONSAVE="fnSave()"
   ONLOAD="fnLoad()">
</DIV>
</BODY>
</HTML>
This feature requires Internet Explorer 5 or later. Click the icon below to install the latest version. Then reload this page to view the sample.
Microsoft Internet Explorer

Applies To

[ Object Name ]
PlatformVersion
Win16:
Win32:
Mac:
Unix:
WinCE:
Version data is listed when the mouse hovers over a link, or the link has focus.
saveFavorite, saveHistory, userData

See Also

persistence overviewInternet Link

Back to topBack to top

Did you find this topic useful? Suggestions for other topics? write us!Internet Link

© 1999 microsoft corporation. all rights reserved. terms of useInternet Link.