XmlDocument.GetElementsByTagName Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.dll, System.Xml.XmlDocument.dll

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.XmlDocument.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

XmlNodeList Vrátí seznam všech následnických prvků, které odpovídají zadanému názvu.

Přetížení

GetElementsByTagName(String)	XmlNodeList Vrátí seznam všech následnických prvků, které odpovídají zadanému Nameznaku .
GetElementsByTagName(String, String)	XmlNodeList Vrátí seznam všech následnických prvků, které odpovídají zadanému LocalName a NamespaceURI.

GetElementsByTagName(String)

XmlNodeList Vrátí seznam všech následnických prvků, které odpovídají zadanému Nameznaku .

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

Parametry

name

String

Kvalifikovaný název, který se má shodovat. Porovná se s Name vlastností odpovídajícího uzlu. Speciální hodnota "*" odpovídá všem značek.

Návraty

XmlNodeList

Obsahuje XmlNodeList seznam všech odpovídajících uzlů. Pokud se žádné uzly neshodují name, vrácená kolekce bude prázdná.

Příklady

Následující příklad vytvoří XmlDocument objekt a použije metodu GetElementsByTagName a výsledný XmlNodeList objekt k zobrazení všech názvů knih.

#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

V příkladu se books.xml soubor používá jako vstup.

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

Poznámky

Uzly jsou umístěny v pořadí, ve kterém by byly zjištěny v dokumentu.

Poznámka

Místo metody se doporučuje použít XmlNode.SelectNodes metodu nebo XmlNode.SelectSingleNode metodu GetElementsByTagName .

GetElementsByTagName(String, String)

XmlNodeList Vrátí seznam všech následnických prvků, které odpovídají zadanému LocalName a 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

Parametry

localName

String

LocalName, který se má shodovat. Speciální hodnota "*" odpovídá všem značek.

namespaceURI

String

Identifikátor NAMESPACEURI, který se má shodovat.

Návraty

XmlNodeList

Obsahuje XmlNodeList seznam všech odpovídajících uzlů. Pokud se zadané uzly neshodují localName a namespaceURIvrácená kolekce bude prázdná.

Poznámky

Uzly jsou umístěny v pořadí, ve kterém by byly zjištěny ve stromu dokumentů.

Poznámka

Místo metody se doporučuje použít XmlNode.SelectNodes metodu nebo XmlNode.SelectSingleNode metodu GetElementsByTagName .