XmlElement.GetElementsByTagName Methode

Definitie

Retourneert een XmlNodeList met een lijst met alle onderliggende elementen die overeenkomen met de opgegeven naam.

Overloads

Name Description
GetElementsByTagName(String, String)

Retourneert een XmlNodeList met een lijst met alle onderliggende elementen die overeenkomen met de opgegeven LocalName en NamespaceURI.

GetElementsByTagName(String)

Retourneert een XmlNodeList met een lijst met alle onderliggende elementen die overeenkomen met de opgegeven Name.

GetElementsByTagName(String, String)

Retourneert een XmlNodeList met een lijst met alle onderliggende elementen die overeenkomen met de opgegeven LocalName en NamespaceURI.

public:
 virtual System::Xml::XmlNodeList ^ GetElementsByTagName(System::String ^ localName, System::String ^ namespaceURI);
public virtual System.Xml.XmlNodeList GetElementsByTagName(string localName, string namespaceURI);
abstract member GetElementsByTagName : string * string -> System.Xml.XmlNodeList
override this.GetElementsByTagName : string * string -> System.Xml.XmlNodeList
Public Overridable Function GetElementsByTagName (localName As String, namespaceURI As String) As XmlNodeList

Parameters

localName
String

De lokale naam die moet overeenkomen. Het sterretje (*) is een speciale waarde die overeenkomt met alle tags.

namespaceURI
String

De naamruimte-URI die moet overeenkomen.

Retouren

Een XmlNodeList met een lijst met alle overeenkomende knooppunten. De lijst is leeg als er geen overeenkomende knooppunten zijn.

Opmerkingen

De knooppunten worden geplaatst in de volgorde waarin ze zouden worden aangetroffen in een voorbestelling doorkruising van de XmlElement boomstructuur.

Note

Het wordt aanbevolen om de XmlNode.SelectNodes of XmlNode.SelectSingleNode methode te gebruiken in plaats van de GetElementsByTagName methode.

Van toepassing op

GetElementsByTagName(String)

Retourneert een XmlNodeList met een lijst met alle onderliggende elementen die overeenkomen met de opgegeven Name.

public:
 virtual System::Xml::XmlNodeList ^ GetElementsByTagName(System::String ^ name);
public virtual System.Xml.XmlNodeList GetElementsByTagName(string name);
abstract member GetElementsByTagName : string -> System.Xml.XmlNodeList
override this.GetElementsByTagName : string -> System.Xml.XmlNodeList
Public Overridable Function GetElementsByTagName (name As String) As XmlNodeList

Parameters

name
String

De naamtag die moet overeenkomen. Dit is een gekwalificeerde naam. Deze wordt vergeleken met de Name eigenschap van het overeenkomende knooppunt. Het sterretje (*) is een speciale waarde die overeenkomt met alle tags.

Retouren

Een XmlNodeList met een lijst met alle overeenkomende knooppunten. De lijst is leeg als er geen overeenkomende knooppunten zijn.

Voorbeelden

In het volgende voorbeeld worden alle boektitels weergegeven.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
     XmlDocument doc = new 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);
     }
  }
}
Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    Dim doc as XmlDocument = new XmlDocument()
    doc.Load("2books.xml")
                         
     ' Get and display all the book titles.
     Dim root as XmlElement = doc.DocumentElement
     Dim elemList as XmlNodeList = root.GetElementsByTagName("title")
     Dim i as integer
     for i=0  to elemList.Count-1
        Console.WriteLine(elemList.ItemOf(i).InnerXml)
     next
    
  end sub
end class

In het voorbeeld wordt het bestand als 2books.xmlinvoer gebruikt.

<!--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>

Opmerkingen

De knooppunten worden geplaatst in de volgorde waarin ze zouden worden aangetroffen in een voorbestelling doorkruising van de XmlElement boomstructuur.

Note

Het wordt aanbevolen om de XmlNode.SelectNodes of XmlNode.SelectSingleNode methode te gebruiken in plaats van de GetElementsByTagName methode.

Van toepassing op