XmlDocument.GetElementsByTagName Método

Definição

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

Sobrecargas

Nome Description
GetElementsByTagName(String)

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

GetElementsByTagName(String, String)

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

GetElementsByTagName(String)

Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.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

O nome qualificado a ser correspondido. Ele é correspondido com a Name propriedade do nó correspondente. O valor especial "*" corresponde a todas as marcas.

Retornos

Uma XmlNodeList lista contendo todos os nós correspondentes. Se nenhum nó corresponder name, a coleção retornada estará vazia.

Exemplos

O exemplo a seguir cria um XmlDocument objeto e usa o GetElementsByTagName método e o objeto resultante XmlNodeList para exibir todos os títulos do livro.

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

O exemplo usa o books.xml arquivo como entrada.

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

Comentários

Os nós são colocados na ordem em que seriam encontrados no documento.

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, String)

Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.cs
Origem:
XmlDocument.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 LocalName a ser correspondido. O valor especial "*" corresponde a todas as marcas.

namespaceURI
String

NamespaceURI a ser correspondido.

Retornos

Uma XmlNodeList lista contendo todos os nós correspondentes. Se nenhum nó corresponder ao especificado e localNamea coleção retornada namespaceURI estiver vazia.

Comentários

Os nós são colocados na ordem em que seriam encontrados na árvore de documentos.

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