XmlElement.GetElementsByTagName Methode

Definition

Namespace:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.XmlDocument.dll
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Gibt eine XmlNodeList Liste aller untergeordneten Elemente zurück, die dem angegebenen Namen entsprechen.

Überlädt

Name Beschreibung
GetElementsByTagName(String, String)

Gibt eine XmlNodeList Liste aller untergeordneten Elemente zurück, die mit dem angegebenen LocalName und NamespaceURI.
GetElementsByTagName(String)

Gibt eine XmlNodeList Liste aller untergeordneten Elemente zurück, die mit dem angegebenen Element Nameübereinstimmen.

GetElementsByTagName(String, String)

Quelle:
XmlElement.cs
Quelle:
XmlElement.cs
Quelle:
XmlElement.cs
Quelle:
XmlElement.cs
Quelle:
XmlElement.cs

Gibt eine XmlNodeList Liste aller untergeordneten Elemente zurück, die mit dem angegebenen LocalName und 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

Parameter

localName
String

Der lokale Name, der übereinstimmen soll. Das Sternchen (*) ist ein spezieller Wert, der allen Tags entspricht.

namespaceURI
String

Der namespace-URI, der übereinstimmen soll.

Gibt zurück

XmlNodeList

Eine XmlNodeList Liste aller übereinstimmenden Knoten. Die Liste ist leer, wenn keine übereinstimmenden Knoten vorhanden sind.

Hinweise

Die Knoten werden in der Reihenfolge platziert, in der sie in einer vorgeordneten Durchquerung der XmlElement Struktur gefunden werden.

Note

Es wird empfohlen, anstelle der XmlNode.SelectNodes Methode die XmlNode.SelectSingleNode Methode zu GetElementsByTagName verwenden.

Gilt für:

GetElementsByTagName(String)

Quelle:
XmlElement.cs
Quelle:
XmlElement.cs
Quelle:
XmlElement.cs
Quelle:
XmlElement.cs
Quelle:
XmlElement.cs

Gibt eine XmlNodeList Liste aller untergeordneten Elemente zurück, die mit dem angegebenen Element Nameübereinstimmen.

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

Parameter

name
String

Das zuzuordnende Namenstag. Dies ist ein qualifizierter Name. Sie wird mit der Name Eigenschaft des übereinstimmenden Knotens abgeglichen. Das Sternchen (*) ist ein spezieller Wert, der allen Tags entspricht.

Gibt zurück

XmlNodeList

Eine XmlNodeList Liste aller übereinstimmenden Knoten. Die Liste ist leer, wenn keine übereinstimmenden Knoten vorhanden sind.

Beispiele

Das folgende Beispiel ruft alle Buchtitel ab und zeigt sie an.

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

Im Beispiel wird die Datei als 2books.xmlEingabe verwendet.

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

Hinweise

Die Knoten werden in der Reihenfolge platziert, in der sie in einer vorgeordneten Durchquerung der XmlElement Struktur gefunden werden.

Note

Es wird empfohlen, anstelle der XmlNode.SelectNodes Methode die XmlNode.SelectSingleNode Methode zu GetElementsByTagName verwenden.

Gilt für: