Freigeben über


XmlElement.GetElementsByTagName Methode

Definition

Gibt eine XmlNodeList mit einer Liste aller Nachfolgerelemente zurück, die mit dem angegebenen Namen übereinstimmen.

Überlädt

GetElementsByTagName(String, String)

Gibt eine XmlNodeList mit einer Liste aller untergeordneten Elemente zurück, die mit dem angegebenen LocalName und NamespaceURI übereinstimmen.

GetElementsByTagName(String)

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

GetElementsByTagName(String, String)

Gibt eine XmlNodeList mit einer Liste aller untergeordneten Elemente zurück, die mit dem angegebenen LocalName und NamespaceURI übereinstimmen.

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, mit dem eine Übereinstimmung gefunden werden soll. Das Sternchen (*) ist ein spezieller Wert, der allen Tags entspricht.

namespaceURI
String

Der Namespace-URI, mit dem Übereinstimmungen gefunden werden sollen.

Gibt zurück

XmlNodeList

Eine XmlNodeList mit einer 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 auftreten würden.

Hinweis

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

Gilt für

GetElementsByTagName(String)

Gibt eine XmlNodeList mit einer Liste aller untergeordneten Elemente zurück, die mit dem angegebenen 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 name-Tag, das abgeglichen werden soll. Dies ist ein qualifizierter Name. Er wird mit der Name-Eigenschaft des übereinstimmenden Knotens verglichen. Das Sternchen (*) ist ein spezieller Wert, der allen Tags entspricht.

Gibt zurück

XmlNodeList

Eine XmlNodeList mit einer 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.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 );
   }
}
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 auftreten würden.

Hinweis

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

Gilt für