XmlElement.GetElementsByTagName Método

  • Referência

Definição

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

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

Sobrecargas

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.

GetElementsByTagName(String, String)

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

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 nome local a ser correspondido. O asterisco (*) é um valor especial que corresponde a todas as marcas.

namespaceURI
String

O URI do namespace que deverá ser correspondido.

Retornos

XmlNodeList

Um XmlNodeList que contém uma lista de todos os nós correspondentes. A lista está vazia se não houver nenhum nó correspondente.

Comentários

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

Observação

É recomendável que você use 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

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

A identificação de nome a ser comparada. Este é um nome qualificado. Ele é comparado com a propriedade Name do nó correspondente. O asterisco (*) é um valor especial que corresponde a todas as marcas.

Retornos

XmlNodeList

Um XmlNodeList que contém uma lista de todos os nós correspondentes. A lista está vazia se não houver nenhum nó correspondente.

Exemplos

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

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
   XmlDocument^ doc = gcnew 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 );
   }
}

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.

Observação

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

Aplica-se a