XmlDocument.GetElementsByTagName Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

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

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.XmlDocument.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Zwraca obiekt XmlNodeList zawierający listę wszystkich elementów podrzędnych, które są zgodne z określoną nazwą.

Przeciążenia

GetElementsByTagName(String)	Zwraca obiekt XmlNodeList zawierający listę wszystkich elementów potomnych, które pasują do określonego Nameelementu .
GetElementsByTagName(String, String)	Zwraca obiekt XmlNodeList zawierający listę wszystkich elementów potomnych, które są zgodne z określonymi LocalName elementami i NamespaceURI.

GetElementsByTagName(String)

Zwraca obiekt XmlNodeList zawierający listę wszystkich elementów potomnych, które pasują do określonego Nameelementu .

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

Kwalifikowana nazwa, która ma być zgodna. Jest ona dopasowywana do Name właściwości pasującego węzła. Wartość specjalna "*" pasuje do wszystkich tagów.

Zwraca

XmlNodeList

Obiekt XmlNodeList zawierający listę wszystkich pasujących węzłów. Jeśli żadne węzły nie są zgodne name, zwrócona kolekcja będzie pusta.

Przykłady

Poniższy przykład tworzy XmlDocument obiekt i używa GetElementsByTagName metody i obiektu wynikowego XmlNodeList do wyświetlania wszystkich tytułów książki.

#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

W przykładzie użyto books.xml pliku jako danych wejściowych.

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

Uwagi

Węzły są umieszczane w kolejności, w której zostaną napotkane w dokumencie.

Uwaga

Zaleca się użycie XmlNode.SelectNodes metody lub XmlNode.SelectSingleNode zamiast GetElementsByTagName metody .

GetElementsByTagName(String, String)

Zwraca obiekt XmlNodeList zawierający listę wszystkich elementów potomnych, które są zgodne z określonymi LocalName elementami i 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

Nazwa_lokalna, która ma być zgodna. Wartość specjalna "*" pasuje do wszystkich tagów.

namespaceURI

String

Identyfikator NAMEspaceURI do dopasowania.

Zwraca

XmlNodeList

Obiekt XmlNodeList zawierający listę wszystkich pasujących węzłów. Jeśli żadne węzły nie są zgodne z określonymi localName wartościami i namespaceURI, zwrócona kolekcja będzie pusta.

Uwagi

Węzły są umieszczane w kolejności, w której zostaną napotkane w drzewie dokumentów.

Uwaga

Zaleca się użycie XmlNode.SelectNodes metody lub XmlNode.SelectSingleNode zamiast GetElementsByTagName metody .