resolveExternals Property


Indicates whether external definitions, resolvable namespaces, document type definition (DTD) external subsets, and external entity references, are to be resolved at parse time, independent of validation.

Script Syntax

boolValue = oXMLDOMDocument.resolveExternals;  
objXMLDOMDocument.resolveExternals = boolVal;  


The following script example sets the resolveExternals property to false before loading a document.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.3.0");
xmlDoc.async = false;
xmlDoc.resolveExternals = false;
if (xmlDoc.parseError.errorCode != 0) {
   var myErr = xmlDoc.parseError;
   WScript.Echo("You have error " + myErr.reason);
   WScript.Echo("Parse successful");

Visual Basic Syntax

boolValue = oXMLDOMDocument.resolveExternals  
objXMLDOMDocument.resolveExternals = boolVal;  


Boolean. The property is read/write.

When the isResolving parameter is True, external definitions are resolved at parse time. This allows default attributes and data types to be defined on elements from the schema and allows use of the DTD as a file inclusion mechanism.

This setting is independent of whether validation is to be performed, as indicated by the value of the validateOnParse property. If externals cannot be resolved during validation, a validation error occurs. When the value of isResolving is False, externals are not resolved and validation is not performed.

A resolvable namespace is indicated by a namespace Universal Resource Identifier (URI) that begins with "x-schema:" as its prefix.

In MSXML 3.0 and MSXML 6.0 the default resolveExternals value is True. In MSXML 6.0, the default setting is False.

If this property is set to False, no external includes and imports will be resolved.

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


Implemented in:

MSXML 3.0 and MSXML 6.0

Applies to


See Also

validateOnParse Property