Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

Normalizes all descendant elements by combining two or more adjacent text nodes into one unified text node.

Script Syntax

Copy Code
oXMLDOMElement.normalize();

Remarks

Script Parameters

None.

Script Return Value

None.

C/C++ Syntax

Copy Code
HRESULT normalize(void);

Remarks

C/C++ Parameters

None.

C/C++ Return Values

S_OK

Value returned if successful.

E_FAIL

Value returned if an error occurs.

Requirements

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

General Remarks

This method converts all text node descendants of this element (at any depth) into a normal form where no text nodes are adjacent. In normal form, text nodes can be separated only by markup, such as tags, comments, processing instructions, CDATA sections, and entity references. The normal form is useful for operations that require a particular document tree structure and ensures that the XML Document Object Model (DOM) view of a document is identical when saved and reloaded.

Collapsed node objects are automatically deleted.

This method applies to the following objects and interfaces:

IXMLDOMText, and IXMLDOMElement.