XmlElement.GetElementsByTagName Método

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
System.Xml.dll, System.Xml.XmlDocument.dll
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.XmlDocument.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Devolve um XmlNodeList contendo uma lista de todos os elementos descendentes que correspondem ao nome especificado.

Sobrecargas

Name Description
GetElementsByTagName(String, String)

Devolve um XmlNodeList contendo uma lista de todos os elementos descendentes que correspondem aos especificados LocalName e NamespaceURI.
GetElementsByTagName(String)

Devolve um XmlNodeList contendo uma lista de 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

Devolve um XmlNodeList contendo uma lista de todos os elementos descendentes que correspondem aos especificados 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 para corresponder. O asterisco (*) é um valor especial que corresponde a todas as etiquetas.

namespaceURI
String

O URI do namespace para corresponder.

Devoluções

XmlNodeList

An XmlNodeList contendo uma lista de todos os nós correspondentes. A lista fica vazia se não houver nós correspondentes.

Observações

Os nós são colocados na ordem em que seriam encontrados numa travessia pré-ordem da XmlElement árvore.

Note

Recomenda-se que utilize o XmlNode.SelectNodes método ou XmlNode.SelectSingleNode 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

Devolve um XmlNodeList contendo uma lista de 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 etiqueta com o nome para combinar. Este é um nome qualificado. É comparado com a Name propriedade do nó correspondente. O asterisco (*) é um valor especial que corresponde a todas as etiquetas.

Devoluções

XmlNodeList

An XmlNodeList contendo uma lista de todos os nós correspondentes. A lista fica vazia se não houver nós correspondentes.

Exemplos

O exemplo seguinte mostra e mostra todos os títulos dos livros.

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

Observações

Os nós são colocados na ordem em que seriam encontrados numa travessia pré-ordem da XmlElement árvore.

Note

Recomenda-se que utilize o XmlNode.SelectNodes método ou XmlNode.SelectSingleNode em vez do GetElementsByTagName método.

Aplica-se a