Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

firstChild Property

Contains the first child of the node.

Copy 
var objXMLDOMNode = oXMLDOMNode.firstChild;

Example

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

JScript
Copy 
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);
}
Copy 
Set objXMLDOMNode = oXMLDOMNode.firstChild
Copy 
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.

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.

Implemented in:

MSXML 3.0, MSXML 6.0

Did you find this helpful?
(1500 characters remaining)