item Method (IXMLDOMNodeList)
Allows random access to individual nodes within the collection.
Script Syntax
var objXMLDOMNode = oXMLDOMNodeList.item(index);
Parameters
- index
- A long integer. An index of the item within the collection. The first item is zero.
Return Value
An object. Returns IXMLDOMNode
. Returns Null if the index is out of range.
Example
The following script example creates an IXMLDOMNodeList
object with the document's getElementsByTagName
method. It then iterates through the collection, displaying the text value of each item in the list.
var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.5.0"); var objNodeList; xmlDoc.async = false; xmlDoc.load("books.xml"); if (xmlDoc.parseError.errorCode != 0) { var myErr = xmlDoc.parseError; alert("You have error " + myErr.reason); } else { objNodeList = xmlDoc.getElementsByTagName("author"); for (var i=0; i<objNodeList.length; i++) { alert(objNodeList.item(i).text); } }
Visual Basic Syntax
Set objXMLDOMNode = oXMLDOMNodeList.item(index)
Parameters
- index
- A long integer. An index of the item within the collection. The first item is zero.
Return Value
An object. Returns IXMLDOMNode
. Returns Null if the index is out of range.
Example
The following Microsoft® Visual Basic® example creates an IXMLDOMNodeList
object with the document's getElementsByTagName
method. It then iterates through the collection, displaying the text value of each item in the list.
Dim xmlDoc As New Msxml2.DOMDocument50 Dim objNodeList As IXMLDOMNodeList xmlDoc.async = False xmlDoc.Load ("books.xml") If (xmlDoc.parseError.errorCode <> 0) Then Dim myErr Set myErr = xmlDoc.parseError MsgBox("You have error " & myErr.reason) Else Set objNodeList = xmlDoc.getElementsByTagName("author") For i = 0 To (objNodeList.length - 1) MsgBox objNodeList.Item(i).Text Next End If
C/C++ Syntax
HRESULT get_item( long index, IXMLDOMNode **listItem);
Parameters
- index [in]
- An index of the item within the collection. The first item is number zero.
- listItem [out, retval]
- An
IXMLDOMNode
. Returns Null if the index is out of range.
C/C++ Return Values
- S_OK
- The value returned if successful.
- E_INVALIDARG
- The value returned if the
listItem
parameter is Null.
To view reference information for Visual Basic, C/C++, or Script only, click the Language Filter button in the upper-left corner of the page.
See Also
Applies to: IXMLDOMNodeList | IXMLDOMSelection