resolveExternals Property

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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;

Remarks

Script Parameters

None.

Script Return Value

Boolean. True if external definitions are to be resolved at parse time; False otherwise. The default is True.

C/C++ Syntax

HRESULT get_resolveExternals(
  VARIANT_BOOL* isResolving
);
HRESULT put_resolveExternals(
  VARIANT_BOOL isResolving
);

Remarks

C/C++ Parameters

  • isResolving
    [out, retval][in] True if external definitions are to be resolved at parse time; False otherwise. The default is True.

C/C++ Return Values

  • S_OK
    Value returned if successful.
  • E_INVALIDARG (for get_resolveExternals only)
    Value returned if isResolving is Null.

Requirements

Header msxml2.h, msxml2.idl
Windows Embedded CE Windows CE .NET 4.0 and later

General Remarks

When isResolving 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.

The default setting is True.

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

This property is read/write, and applies to the following interface:

DOMDocument.

See Also

Concepts

validateOnParse Property