XmlElement.GetElementsByTagName Methode

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, 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)

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)

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

Der lokale Name, mit dem eine Übereinstimmung gefunden werden soll.The local name to match. Das Sternchen (*) ist ein spezieller Wert, der allen Tags entspricht.The asterisk (*) is a special value that matches all tags.

namespaceURI
String

Der Namespace-URI, mit dem Übereinstimmungen gefunden werden sollen.The namespace URI to match.

Gibt zurück

Eine XmlNodeList mit einer Liste aller übereinstimmenden Knoten.An XmlNodeList containing a list of all matching nodes. Die Liste ist leer, wenn keine übereinstimmenden Knoten vorhanden sind.The list is empty if there are no matching nodes.

Hinweise

Die Knoten werden in der Reihenfolge platziert, in der Sie bei einem Preorder-Durchlauf der XmlElement Struktur auftreten würden.The nodes are placed in the order in which they would be encountered in a preorder traversal of the XmlElement tree.

Hinweis

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

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

Das name-Tag, das abgeglichen werden soll.The name tag to match. Dies ist ein qualifizierter Name.This is a qualified name. Er wird mit der Name-Eigenschaft des übereinstimmenden Knotens verglichen.It is matched against the Name property of the matching node. Das Sternchen (*) ist ein spezieller Wert, der allen Tags entspricht.The asterisk (*) is a special value that matches all tags.

Gibt zurück

Eine XmlNodeList mit einer Liste aller übereinstimmenden Knoten.An XmlNodeList containing a list of all matching nodes. Die Liste ist leer, wenn keine übereinstimmenden Knoten vorhanden sind.The list is empty if there are no matching nodes.

Beispiele

Im folgenden Beispiel werden alle Buch Titel abgerufen und angezeigt.The following example gets and displays all the book titles.

#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 (2books.xml) als Eingabe verwendet.The example uses the file, 2books.xml, as input.

<!--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 bei einem Preorder-Durchlauf der XmlElement Struktur auftreten würden.The nodes are placed in the order in which they would be encountered in a preorder traversal of the XmlElement tree.

Hinweis

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

Gilt für: