[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
In MSXML, "free-threaded" means
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);
IXMLDOMNode object to be cloned.
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.
The node is cloned successfully.
The node cannot be cloned properly and the resultant
clone parameter is NULL.
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
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