XmlElement.GetElementsByTagName Método

Definição

Namespace:
System.Xml
Assemblies:
System.Xml.dll, System.Xml.XmlDocument.dll
Assemblies:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Retorna uma XmlNodeList lista contendo todos os elementos descendentes que correspondem ao nome especificado.

Sobrecargas

Nome Description
GetElementsByTagName(String, String)

Retorna uma XmlNodeList lista contendo todos os elementos descendentes que correspondem ao especificado LocalName e NamespaceURI.
GetElementsByTagName(String)

Retorna uma XmlNodeList lista contendo todos os elementos descendentes que correspondem ao especificado Name.

GetElementsByTagName(String, String)

Origem:
XmlElement.cs
Origem:
XmlElement.cs
Origem:
XmlElement.cs
Origem:
XmlElement.cs
Origem:
XmlElement.cs

Retorna uma XmlNodeList lista contendo todos os elementos descendentes que correspondem ao especificado LocalName e 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

Parâmetros

localName
String

O nome local a ser correspondido. O asterisco (*) é um valor especial que corresponde a todas as marcas.

namespaceURI
String

O URI do namespace a ser correspondido.

Retornos

XmlNodeList

Uma XmlNodeList lista contendo todos os nós correspondentes. A lista estará vazia se não houver nós correspondentes.

Comentários

Os nós são colocados na ordem em que seriam encontrados em uma passagem de pré-encomenda da XmlElement árvore.

Note

É recomendável que você use o método ou XmlNode.SelectNodes o XmlNode.SelectSingleNode método em vez do GetElementsByTagName método.

Aplica-se a

GetElementsByTagName(String)

Origem:
XmlElement.cs
Origem:
XmlElement.cs
Origem:
XmlElement.cs
Origem:
XmlElement.cs
Origem:
XmlElement.cs

Retorna uma XmlNodeList lista contendo todos os elementos descendentes que correspondem ao especificado 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

Parâmetros

name
String

A marca de nome a ser correspondida. Esse é um nome qualificado. Ele é correspondido com a Name propriedade do nó correspondente. O asterisco (*) é um valor especial que corresponde a todas as marcas.

Retornos

XmlNodeList

Uma XmlNodeList lista contendo todos os nós correspondentes. A lista estará vazia se não houver nós correspondentes.

Exemplos

O exemplo a seguir obtém e exibe todos os títulos do livro.

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

O exemplo usa o arquivo, 2books.xmlcomo entrada.

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

Comentários

Os nós são colocados na ordem em que seriam encontrados em uma passagem de pré-encomenda da XmlElement árvore.

Note

É recomendável que você use o método ou XmlNode.SelectNodes o XmlNode.SelectSingleNode método em vez do GetElementsByTagName método.

Aplica-se a