Język

XmlElement.GetElementsByTagName Metoda

Definicja

Przestrzeń nazw:
System.Xml
Zestawy:
System.Xml.dll, System.Xml.XmlDocument.dll
Zestawy:
netstandard.dll, System.Xml.ReaderWriter.dll
Zestaw:
System.Xml.XmlDocument.dll
Zestaw:
System.Xml.ReaderWriter.dll
Zestaw:
System.Xml.dll
Zestaw:
netstandard.dll

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

Przeciążenia

Nazwa Opis
GetElementsByTagName(String, String)

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

XmlNodeList Zwraca obiekt zawierający listę wszystkich elementów potomnych, które są zgodne z określonym Nameelementem .

GetElementsByTagName(String, String)

Źródło:
XmlElement.cs
Źródło:
XmlElement.cs
Źródło:
XmlElement.cs
Źródło:
XmlElement.cs
Źródło:
XmlElement.cs

XmlNodeList Zwraca obiekt 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. Gwiazdka (*) jest specjalną wartością zgodną ze wszystkimi tagami.

namespaceURI
String

Identyfikator URI przestrzeni nazw do dopasowania.

Zwraca

XmlNodeList

Obiekt XmlNodeList zawierający listę wszystkich pasujących węzłów. Lista jest pusta, jeśli nie ma pasujących węzłów.

Uwagi

Węzły są umieszczane w kolejności, w której zostaną napotkane w przedorderowym przechodzeniu XmlElement drzewa.

Note

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

Dotyczy

GetElementsByTagName(String)

Źródło:
XmlElement.cs
Źródło:
XmlElement.cs
Źródło:
XmlElement.cs
Źródło:
XmlElement.cs
Źródło:
XmlElement.cs

XmlNodeList Zwraca obiekt zawierający listę wszystkich elementów potomnych, które są zgodne z określonym Nameelementem .

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

Tag nazwy, który ma być zgodny. Jest to kwalifikowana nazwa. Jest on zgodny z właściwością Name pasującego węzła. Gwiazdka (*) jest specjalną wartością zgodną ze wszystkimi tagami.

Zwraca

XmlNodeList

Obiekt XmlNodeList zawierający listę wszystkich pasujących węzłów. Lista jest pusta, jeśli nie ma pasujących węzłów.

Przykłady

Poniższy przykład pobiera i wyświetla wszystkie tytuły książek.

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

W przykładzie użyto pliku , 2books.xmljako danych wejściowych.

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

Uwagi

Węzły są umieszczane w kolejności, w której zostaną napotkane w przedorderowym przechodzeniu XmlElement drzewa.

Note

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

Dotyczy