IXMLDOMDocument::resolveExternals Method

IXMLDOMDocument::get_resolveExternals Method

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

Visual Basic Syntax

boolValue = oXMLDOMDocument.resolveExternals

C/C++ Syntax

HRESULT get_resolveExternals(
    VARIANT_BOOL *isResolving);

Parameters

isResolving [out]

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

Value returned if isResolving is Null.

---

IXMLDOMDocument::put_resolveExternals Method

Indicates that external definitions (resolvable namespaces, DTD external subsets, and external entity references) are to be resolved at parse time.

Visual Basic Syntax

objXMLDOMDocument.resolveExternals = boolValue

C/C++ Syntax

HRESULT put_resolveExternals(
    VARIANT_BOOL isResolving);

Parameters

isResolving [in]

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

Return Values

Returns S_OK if successful, or an error code otherwise.

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 URI that begins with "x-schema:" as its prefix.

See Also

IXMLDOMDocument Interface