XmlDocument.GetElementsByTagName Método

Definición

Espacio de nombres:

System.Xml

Ensamblados:

System.Xml.dll, System.Xml.XmlDocument.dll

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.XmlDocument.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Devuelve un objeto XmlNodeList que contiene una lista de todos los elementos descendientes que coinciden con el nombre especificado.

Sobrecargas

GetElementsByTagName(String)	Devuelve un objeto XmlNodeList que contiene una lista de todos los elementos descendientes que coinciden con el Name especificado.
GetElementsByTagName(String, String)	Devuelve un objeto XmlNodeList que contiene una lista de todos los elementos descendientes que coinciden con el LocalName y NamespaceURI especificados.

GetElementsByTagName(String)

Devuelve un objeto XmlNodeList que contiene una lista de todos los elementos descendientes que coinciden con el 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

Nombre completo que se va a hacer coincidir. Se compara con la propiedad Name del nodo coincidente. El valor especial "*" coincide con todas las etiquetas.

Devoluciones

XmlNodeList

Objeto XmlNodeList que contiene una lista de todos los nodos coincidentes. Si ningún nodo coincide con name, se devolverá la colección vacía.

Ejemplos

En el ejemplo siguiente se crea un XmlDocument objeto y se usa el GetElementsByTagName método y el objeto resultante XmlNodeList para mostrar todos los títulos del libro.

#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

En el ejemplo se utiliza como entrada el archivo books.xml.

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

Comentarios

Los nodos se colocan en el orden en que se encontrarían en el documento.

Nota

Se recomienda usar el XmlNode.SelectNodes método o XmlNode.SelectSingleNode en lugar del GetElementsByTagName método .

GetElementsByTagName(String, String)

Devuelve un objeto XmlNodeList que contiene una lista de todos los elementos descendientes que coinciden con el LocalName y 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

Nombre local que se va a hacer coincidir. El valor especial "*" coincide con todas las etiquetas.

namespaceURI

String

Identificador URI de espacio de nombres con el que debe haber una coincidencia.

Devoluciones

XmlNodeList

Objeto XmlNodeList que contiene una lista de todos los nodos coincidentes. Si ningún nodo coincide con el localName y namespaceURI especificados, se devolverá la colección vacía.

Comentarios

Los nodos se colocan en el orden en que se encontrarían en el árbol de documentos.

Nota

Se recomienda usar el XmlNode.SelectNodes método o XmlNode.SelectSingleNode en lugar del GetElementsByTagName método .