XmlDocument.GetElementsByTagName XmlDocument.GetElementsByTagName XmlDocument.GetElementsByTagName XmlDocument.GetElementsByTagName Method

Definition

Gibt eine XmlNodeList mit einer Liste aller Nachfolgerelemente zurück, die mit dem angegebenen Namen übereinstimmen.Returns an XmlNodeList containing a list of all descendant elements that match the specified name.

Überlädt

GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String)

Gibt eine XmlNodeList mit einer Liste aller untergeordneten Elemente zurück, die mit dem angegebenen Name übereinstimmen.Returns an XmlNodeList containing a list of all descendant elements that match the specified Name.

GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String)

Gibt eine XmlNodeList mit einer Liste aller untergeordneten Elemente zurück, die mit dem angegebenen LocalName und NamespaceURI übereinstimmen.Returns an XmlNodeList containing a list of all descendant elements that match the specified LocalName and NamespaceURI.

GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String)

Gibt eine XmlNodeList mit einer Liste aller untergeordneten Elemente zurück, die mit dem angegebenen Name übereinstimmen.Returns an XmlNodeList containing a list of all descendant elements that match the specified 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

Parameter

name
String String String String

Der qualifizierte Name, mit dem eine Übereinstimmung gefunden werden soll.The qualified name to match. Er wird mit der Name-Eigenschaft des übereinstimmenden Knotens verglichen.It is matched against the Name property of the matching node. Der spezielle Wert „*“ entspricht allen Tags.The special value "*" matches all tags.

Gibt zurück

Eine XmlNodeList mit einer Liste aller übereinstimmenden Knoten.An XmlNodeList containing a list of all matching nodes. Wenn mit name keine Knoten übereinstimmen, ist die zurückgegebene Auflistung leer.If no nodes match name, the returned collection will be empty.

Beispiele

Im folgenden Beispiel wird ein XmlDocument -Objekt erstellt und GetElementsByTagName die-Methode und XmlNodeList das resultierende-Objekt verwendet, um alle Buch Titel anzuzeigen.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 );
   }
}
using System;
using System.IO;
using System.Xml;

public class Sample
{
  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.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>

Hinweise

Die Knoten werden in der Reihenfolge platziert, in der Sie im Dokument gefunden werden.The nodes are placed in the order in which they would be encountered in the document.

Hinweis

Es wird empfohlen, anstelle der- XmlNode.SelectNodes GetElementsByTagName Methode XmlNode.SelectSingleNode die-Methode oder die-Methode zu verwenden.It is recommended that you use the XmlNode.SelectNodes or XmlNode.SelectSingleNode method instead of the GetElementsByTagName method.

GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String)

Gibt eine XmlNodeList mit einer Liste aller untergeordneten Elemente zurück, die mit dem angegebenen LocalName und NamespaceURI übereinstimmen.Returns an XmlNodeList containing a list of all descendant elements that match the specified LocalName and 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 String String String

Der LocalName, mit dem eine Übereinstimmung gefunden werden soll.The LocalName to match. Der spezielle Wert „*“ entspricht allen Tags.The special value "*" matches all tags.

namespaceURI
String String String String

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

Gibt zurück

Eine XmlNodeList mit einer Liste aller übereinstimmenden Knoten.An XmlNodeList containing a list of all matching nodes. Wenn keine mit dem angegebenen localName und dem namespaceURI kein Knoten übereinstimmt, ist die zurückgegebene Auflistung leer.If no nodes match the specified localName and namespaceURI, the returned collection will be empty.

Hinweise

Die Knoten werden in der Reihenfolge platziert, in der Sie in der Dokumentstruktur gefunden werden.The nodes are placed in the order in which they would be encountered in the document tree.

Hinweis

Es wird empfohlen, anstelle der- XmlNode.SelectNodes GetElementsByTagName Methode XmlNode.SelectSingleNode die-Methode oder die-Methode zu verwenden.It is recommended that you use the XmlNode.SelectNodes or XmlNode.SelectSingleNode method instead of the GetElementsByTagName method.

Gilt für: