Share via

getElementsByTagName Method (DOMDocument)

  • Article

Returns a collection of elements that have the specified name.

var objXMLDOMNodeList =
oXMLDOMDocument.getElementsByTagName(tagName);

HRESULT getElementsByTagName(
  BSTR tagName,
  IXMLDOMNodeList** resultList
);

General Remarks

This method is only valid if the XML Query Language (XQL) feature has been included in the operating system (OS). If a call to this method is made and XQL is not supported, an error message will be returned.

The elements in the collection are returned in the order in which they would be encountered in a preorder traversal of the document tree. In a preorder traversal, the parent root node is visited first and each child node from left to right is then traversed.

The returned IXMLDOMNodeList object is live and immediately reflects changes to the nodes that appear in the list.

More complex searches can be performed using the selectNodes Method. This method can also be faster in some cases.

This method applies to the following objects and interfaces:

DOMDocument and IXMLDOMNodeList.

See Also

selectNodes Method

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.