Freigeben über


XmlDocument.GetElementsByTagName Methode

Definition

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

Überlädt

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.

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

Der qualifizierte Name, mit dem eine Übereinstimmung gefunden werden soll. Er wird mit der Name-Eigenschaft des übereinstimmenden Knotens verglichen. Der spezielle Wert „*“ entspricht allen Tags.

Gibt zurück

XmlNodeList

Eine XmlNodeList mit einer Liste aller übereinstimmenden Knoten. Wenn mit name keine Knoten übereinstimmen, ist die zurückgegebene Auflistung leer.

Beispiele

Im folgenden Beispiel wird ein XmlDocument Objekt erstellt und die GetElementsByTagName Methode und das resultierende XmlNodeList Objekt verwendet, um alle Buchtitel anzuzeigen.

#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 );
   }
}
using System;
using System.Xml;

public class Sample1
{
    public static void Main()
    {
        //Create the XmlDocument.
        XmlDocument doc = new 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);
        }
    }
}
Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        doc.Load("books.xml")
        
        'Display all the book titles.
        Dim elemList As XmlNodeList = doc.GetElementsByTagName("title")
        Dim i As Integer
        For i = 0 To elemList.Count - 1
            Console.WriteLine(elemList(i).InnerXml)
        Next i
    End Sub
End Class

In diesem Beispiel wird die Datei books.xml als Eingabe verwendet.

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

Hinweise

Die Knoten werden in der Reihenfolge platziert, in der sie im Dokument auftreten würden.

Hinweis

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

Gilt für

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 LocalName, mit dem eine Übereinstimmung gefunden werden soll. Der spezielle Wert „*“ entspricht allen Tags.

namespaceURI
String

Der NamespaceURI, mit dem eine Übereinstimmung gefunden werden soll.

Gibt zurück

XmlNodeList

Eine XmlNodeList mit einer Liste aller übereinstimmenden Knoten. Wenn keine mit dem angegebenen localName und dem namespaceURI kein Knoten übereinstimmt, ist die zurückgegebene Auflistung leer.

Hinweise

Die Knoten werden in der Reihenfolge platziert, in der sie in der Dokumentstruktur auftreten würden.

Hinweis

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

Gilt für