XmlElement::GetElementsByTagName Method (String^)
Returns an XmlNodeList containing a list of all descendant elements that match the specified Name.
Assembly: System.Xml (in System.Xml.dll)
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.
Note |
|---|
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>
Available since 10
.NET Framework
Available since 1.1
