load Method
TOC
Collapse the table of content
Expand the table of content

load Method

 

Loads an XML document from the specified location.

boolValue = oXMLDOMDocument.load(xmlSource);

 xmlSource 

A string containing a URL that specifies the location of the XML file.

Boolean. Returns True if the load succeeded; False if the load failed.

The following script example creates a DOMDocument object and uses the load method to load a local XML file.

System_CAPS_noteNote

You can use books.xml to run this sample code.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.6.0");
xmlDoc.async = false;
xmlDoc.load("books.xml");
if (xmlDoc.parseError.errorCode != 0) {
   var myErr = xmlDoc.parseError;
   WScript.Echo("You have error " + myErr.reason);
} else {
   WScript.Echo(xmlDoc.xml);
}

Output

Outputs the books.xml file.

HRESULT load(
    VARIANT xmlSource,
    VARIANT_BOOL *isSuccessful);

 xmlSource[in]

An indicator of the source XML to parse. This may be an URL (String/BSTR), a Request object (in an ASP page), an IStream, SAFEARRAY of bytes (VT_ARRAY|VT_UI1), a DOMDocument object, or any object that supports IStream, ISequentialStream, or IPersistStream. See Remarks for more information.

 isSuccessful[out, retval]

True if the load succeeded; False if the load failed.

S_OK

The value returned if successful.

S_FALSE

The value returned if the load fails.

E_INVALIDARG

The value returned if the isSuccessful parameter is Null.

If the URL cannot be resolved or accessed or does not reference an XML document, this method returns an error and sets the documentElement property of the DOMDocument to Null.

The load method can also take any object that supports IStream and the Microsoft® Internet Information Services (IIS) Request object.

Calling load or loadXML on an existing document immediately discards the content of the document.

If loading an XML document from a resource, the load must be performed asynchronously or the load will fail. For example:

Set objXML = CreateObject("Msxml2.DOMDocument.6.0")
ObjXML.async=true
objXML.load "res://msxml3.dll/xml/defaultss.xsl"
If objXML.parseError.errorCode <> 0 Then
   Set myErr = objXML.parseError
   WScript.Echo "You have error " + myErr.reason
Else
   WScript.Echo objXML.parseError.reason
   objXML.save "defaultss.xsl"
End If

You can use this method to check if the loaded XML document is well-formed. You cannot use it to validate the XML document against a schema.

This member is an extension of the World Wide Web Consortium (W3C) Document Object Model (DOM).

When a document is loaded using this method, URLs will be resolved relative to the directory from which the program executed.

Implemented in: MSXML 3.0 and MSXML 6.0

Show:
© 2016 Microsoft