XmlDocument::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 qualified name to match. It is matched against the Name property of the matching node. The special value "*" matches all tags.
Return Value
Type: System.Xml::XmlNodeList^An XmlNodeList containing a list of all matching nodes. If no nodes match name, the returned collection will be empty.
The nodes are placed in the order in which they would be encountered in the document.
Note |
|---|
It is recommended that you use the XmlNode::SelectNodes or XmlNode::SelectSingleNode method instead of the GetElementsByTagName method. |
The following example creates a XmlDocument object and uses the GetElementsByTagName method and the resulting XmlNodeList object to display all the book titles.
#using <System.Xml.dll> using namespace System; using namespace System::IO; using namespace System::Xml; int main() { //Create the XmlDocument. XmlDocument^ doc = gcnew XmlDocument; doc->Load( "books.xml" ); //Display all the book titles. XmlNodeList^ elemList = doc->GetElementsByTagName( "title" ); for ( int i = 0; i < elemList->Count; i++ ) { Console::WriteLine( elemList[ i ]->InnerXml ); } }
The example uses the books.xml file as input.
<?xml version='1.0'?> <!-- This file represents a fragment of a book store inventory database --> <bookstore> <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0"> <title>The Autobiography of Benjamin Franklin</title> <author> <first-name>Benjamin</first-name> <last-name>Franklin</last-name> </author> <price>8.99</price> </book> <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2"> <title>The Confidence Man</title> <author> <first-name>Herman</first-name> <last-name>Melville</last-name> </author> <price>11.99</price> </book> <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6"> <title>The Gorgias</title> <author> <name>Plato</name> </author> <price>9.99</price> </book> </bookstore>
Available since 10
.NET Framework
Available since 1.1
