firstChild Property

Article
2016-10-27

Contains the first child of the node.

Script Syntax

var objXMLDOMNode = oXMLDOMNode.firstChild;

Example

The following example sets currNode to the first child node of the top-level node.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.3.0");
var currNode;
xmlDoc.async = false;
xmlDoc.load("books.xml");
if (xmlDoc.parseError.errorCode != 0) {
   var myErr = xmlDoc.parseError;
   WScript.Echo("You have error " + myErr.reason);
} else {
   currNode = xmlDoc.documentElement.firstChild;
   WScript.Echo(currNode.xml);
}

Visual Basic Syntax

Set objXMLDOMNode = oXMLDOMNode.firstChild

C/C++ Syntax

HRESULT get_firstChild(  
    IXMLDOMNode **firstChild);

Parameters

firstChild[out, retval]
The first child node. If there are no such children, it returns Null.

C/C++ Return Values

S_OK
The value returned if successful.

S_FALSE
The value returned when there are no children.

E_INVALIDARG
The value returned if the firstChild parameter is Null.

Remarks

The property is read-only. Returns the first child node. If there are no such children, returns Null.

This value depends on the value of the nodeType property.

NODE_ATTRIBUTE NODE_DOCUMENT NODE_DOCUMENT_FRAGMENT NODE_DOCUMENT_TYPE NODE_ELEMENT NODE_ENTITY NODE_ENTITY_REFERENCE	Returns the first child node. If there are no children, returns Null.
NODE_CDATA_SECTION NODE_COMMENT NODE_NOTATION NODE_PROCESSING_INSTRUCTION NODE_TEXT	Returns Null. These node types cannot have children.

Versioning

Implemented in:

MSXML 3.0, MSXML 6.0

Applies to

Share via