Share via


firstChild Property

 

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

IXMLDOMAttribute | IXMLDOMCDATASection | IXMLDOMCharacterData | IXMLDOMComment | IXMLDOMDocument-DOMDocument | IXMLDOMDocumentFragment | IXMLDOMDocumentType | IXMLDOMElement | IXMLDOMEntity | IXMLDOMEntityReference | IXMLDOMNode | IXMLDOMNotation | IXMLDOMProcessingInstruction | IXMLDOMText

See Also

nodeType Property1