Partilhar via


XmlDocument.GetElementsByTagName Método

Definição

Retorna um XmlNodeList que contém uma lista de todos os elementos descendentes que correspondem ao nome especificado.

Sobrecargas

GetElementsByTagName(String)

Retorna um XmlNodeList que contém uma lista de todos os elementos descendentes que correspondem ao Name especificado.

GetElementsByTagName(String, String)

Retorna um XmlNodeList que contém uma lista de todos os elementos descendentes que correspondem ao LocalName e NamespaceURI especificados.

GetElementsByTagName(String)

Retorna um XmlNodeList que contém uma lista de todos os elementos descendentes que correspondem ao Name especificado.

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 para correspondência. Ele é comparado com a propriedade Name do nó correspondente. O valor especial “*” corresponde a todas as marcas.

Retornos

XmlNodeList

Um XmlNodeList que contém uma lista de todos os nós correspondentes. Se nenhum nó corresponder a 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.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

O exemplo usa o arquivo books.xml 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.

Observação

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

Aplica-se a

GetElementsByTagName(String, String)

Retorna um XmlNodeList que contém uma lista de todos os elementos descendentes que correspondem ao LocalName e NamespaceURI especificados.

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 de correspondência. O valor especial “*” corresponde a todas as marcas.

namespaceURI
String

NamespaceURI de correspondência.

Retornos

XmlNodeList

Um XmlNodeList que contém uma lista de todos os nós correspondentes. Se nenhum nó corresponder aos localName e namespaceURI especificados, a coleção retornada ficará vazia.

Comentários

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

Observação

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

Aplica-se a