Share via

save Method

  • Article

Saves an XML document to the specified location.

oXMLDOMDocument.save(destination);

HRESULT save(
  VARIANT destination
);

General Remarks

The behavior differs based on the object specified by the objTarget parameter.

Object Description
String Specifies the file name. Note that this must be a file name rather than a URL. The file is created if necessary and the contents are entirely replaced with the contents of the saved document. This mode is not intended for use from a secure client such as Microsoft® Internet Explorer. 
    dim xmldoc
    set xmldoc = Server.CreateObject("Msxml2.DOMDocument")
    xmldoc.load("c:\myfile.xml")
    xmldoc.save(Server.MapPath("sample.xml"))

The Active Server Pages (ASP) Response object sends the document back to the client that invoked the ASP script.

    dim xmldoc
    set xmldoc = Server.CreateObject("Msxml2.DOMDocument")
    xmldoc.load(Server.MapPath("sample.xml"))
    xmldoc.save(Response)
IXMLDocument Object Duplicates the original document. It is the equivalent of saving the document and reparsing it. The document goes through full persistence through XML markup, thereby testing the persistability of your XML document. 
    <script language="jscript">
        var xmldoc1 = new ActiveXObject("Msxml2.DOMDocument");
        var xmldoc2 = new ActiveXObject("Msxml2.DOMDocument");
        xmldoc1.load("sample.xml");
        xmldoc1.save(xmldoc2.XMLDocument);
    </script>
Custom object supporting persistence Any other custom COM object that supports QueryInterface for IStream, IPersistStream, or IPersistStreamInit can also be provided here, and the document will be saved accordingly. In the IStream case, the IStream Write method will be called as it saves the document; in the IPersistStream case, IPersistStream Load will be called with an IStream that supports the Read, Seek, and Stat methods.

External entity references in DOCTYPE, ENTITY, NOTATION, and XML namespace declarations are not changed; they point to the original document. A saved XML document might not load if the URLs are not accessible from the location in which you saved the document.

Character encoding is based on the encoding attribute in the XML declaration, such as <?xml version="1.0" encoding="windows-1252"?>. When no encoding attribute is specified, the default setting is UTF-8.

Validation is not performed during save, which can result in an invalid document that does not load again because of a specified document type definition (DTD). This member is an extension of the World Wide Web Consortium (W3C) Document Object Model (DOM).

This method applies to the following interface:

DOMDocument.

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.