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

Contains the parent node.

Script Syntax

Copy Code 
var objXMLDOMNode = oXMLDOMNode.parentNode;

Remarks

Script Parameters

None.

Script Return Value

Object. All nodes except Document, DocumentFragment, and Attribute nodes can have a parent. However, if a node has just been created and not yet added to the tree, or if it has been removed from the tree, the parent is Null.

C/C++ Syntax

Copy Code 
HRESULT get_parentNode(
  IXMLDOMNode** 
parent
);

Remarks

C/C++ Parameters

parent

[out, retval] Parent of the given node instance. All nodes except Document, DocumentFragment, and Attribute nodes can have a parent. However, if a node has just been created and not yet added to the tree, or if it has been removed from the tree, the parent is Null.

C/C++ Return Values

S_FALSE

Value returned if there is no parent.

S_OK

Value returned if successful.

E_INVALIDARG

Value returned if parentis Null.

Requirements

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

General Remarks

This value depends on the value of the nodeTypeproperty.

Value Description

NODE_ATTRIBUTE, NODE_DOCUMENT, NODE_DOCUMENT_FRAGMENT

Returns Null; these nodes do not have parents.

NODE_CDATA_SECTION

Returns the element or entity reference containing the CDATA section.

NODE_COMMENT

Returns the element, entity reference, document type, or document containing the comment.

NODE_DOCUMENT_TYPE

Returns the document node.

NODE_ELEMENT

Returns the parent node of the element. If the element is the root node in the tree, the parent is the document node. If the node is the document node, parentNodeis Null.

NODE_ENTITY

Returns the document type node.

NODE_ENTITY_REFERENCE

Returns the element, attribute, or entity reference containing the entity reference.

NODE_NOTATION

Returns the document type node.

NODE_PROCESSING_INSTRUCTION

Returns the document, element, document type, or entity reference containing the processing instruction.

NODE_TEXT

Returns the parent element, attribute, or entity reference.

This property is read-only, and applies to the following objects and interfaces:

IXMLDOMAttribute, IXMLDOMCDATASection, IXMLDOMCharacterData, IXMLDOMComment, DOMDocument, IXMLDOMDocumentFragment, IXMLDOMDocumentType, IXMLDOMElement, IXMLDOMEntity, IXMLDOMEntityReference, IXMLDOMNode, IXMLDOMNotation, IXMLDOMProcessingInstruction, IXMLDOMText, and IXTLRuntime

See Also