XmlElement::GetElementsByTagName Method (String^)

 

Returns an XmlNodeList containing a list of all descendant elements that match the specified Name.

Namespace:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public:
virtual XmlNodeList^ GetElementsByTagName(
	String^ name
)

Parameters

name
Type: System::String^

The name tag to match. This is a qualified name. It is matched against the Name property of the matching node. The asterisk (*) is a special value that matches all tags.

Return Value

Type: System.Xml::XmlNodeList^

An XmlNodeList containing a list of all matching nodes. The list is empty if there are no matching nodes.

The nodes are placed in the order in which they would be encountered in a preorder traversal of the XmlElement tree.

System_CAPS_noteNote

It is recommended that you use the XmlNode::SelectNodes or XmlNode::SelectSingleNode method instead of the GetElementsByTagName method.

The following example gets and displays all the book titles.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->Load( "2books.xml" );

   // Get and display all the book titles.
   XmlElement^ root = doc->DocumentElement;
   XmlNodeList^ elemList = root->GetElementsByTagName( "title" );
   for ( int i = 0; i < elemList->Count; i++ )
   {
      Console::WriteLine( elemList[ i ]->InnerXml );
   }
}

The example uses the file, 2books.xml, as input.

<!--sample XML fragment-->
<bookstore>
  <book genre='novel' ISBN='10-861003-324'>
    <title>The Handmaid's Tale</title>
    <price>19.95</price>
  </book>
  <book genre='novel' ISBN='1-861001-57-5'>
    <title>Pride And Prejudice</title>
    <price>24.95</price>
  </book>
</bookstore>

Universal Windows Platform
Available since 10
.NET Framework
Available since 1.1
Return to top
Show: