importNode Method


[This sample code uses features that were implemented only in MSXML 6.0.]

This method can be used to clone a node from a DOM object. In addition to supporting all the functionality offered by the cloneNode method, it enables cloning a node from DOM objects of different threading models. The clones created this way can be passed between such DOM objects. For example, a node from a free-threaded DOM object can be passed into an apartment-threaded DOM object. The resultant node object can then be added into the document using the appendChild method.

System_CAPS_ICON_note.jpg Note

In MSXML, "free-threaded" means ThreadingModel='Both', and cross-thread marshalling is supported.

var clone = objXMLDOMDocument6.importNode(node, deep);  

Set clone = objXMLDOMDocument6.importNode(node, deep);  

IXMLDOMNodePtr clone = objXMLDOMDocument6->importNode(node, deep);  
HRESULT IXMLDOMDocument3::importNode(  
...[in] IXMLDOMNode* node,  
   [in] VARIANT_BOOL deep,  
...[out, retval] IXMLDOMNode** clone);  


An IXMLDOMNode object to be cloned.

If true, any children of node will be cloned as well. If false, no children of node will be cloned.

A clone of the node object, as specified above.

Return Values

The node is cloned successfully.

The node cannot be cloned properly and the resultant clone parameter is NULL.

The importNode method does not allow for import of DOM nodes that are of one of the following enumerated node types: NODE_DOCUMENT, NODE_DOCUMENT_TYPE, NODE_ENTITY, and NODE_NOTATION.

This example demonstrates how to use importNode to clone a node from a free-threaded DOM document and append the clone to a regular apartment-threaded DOM object. As a comparison, it also shows that a DOM object can clone a node from itself with importNode, just as it would with cloneNode.

We've provided source files for the sample in three languages: JScript, Visual Basic, and C++. The output is the same in each language.


Implemented in: MSXML 6.0