XmlElement.GetElementsByTagName Método

Definición

Espacio de nombres:
System.Xml
Ensamblados:
System.Xml.dll, System.Xml.XmlDocument.dll
Ensamblados:
netstandard.dll, System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.XmlDocument.dll
Ensamblado:
System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll

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

Sobrecargas

Nombre Description
GetElementsByTagName(String, String)

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

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

GetElementsByTagName(String, String)

Source:
XmlElement.cs
Source:
XmlElement.cs
Source:
XmlElement.cs
Source:
XmlElement.cs
Source:
XmlElement.cs

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

Nombre local que se va a coincidir. El asterisco (*) es un valor especial que coincide con todas las etiquetas.

namespaceURI
String

Identificador URI del espacio de nombres que se va a coincidir.

Devoluciones

XmlNodeList

que XmlNodeList contiene una lista de todos los nodos coincidentes. La lista está vacía si no hay nodos coincidentes.

Comentarios

Los nodos se colocan en el orden en el que se encontrarían en un recorrido de orden previo del XmlElement árbol.

Note

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

Se aplica a

GetElementsByTagName(String)

Source:
XmlElement.cs
Source:
XmlElement.cs
Source:
XmlElement.cs
Source:
XmlElement.cs
Source:
XmlElement.cs

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

Etiqueta de nombre que se va a coincidir. Se trata de un nombre completo. Coincide con la Name propiedad del nodo coincidente. El asterisco (*) es un valor especial que coincide con todas las etiquetas.

Devoluciones

XmlNodeList

que XmlNodeList contiene una lista de todos los nodos coincidentes. La lista está vacía si no hay nodos coincidentes.

Ejemplos

En el ejemplo siguiente se obtienen y muestran todos los títulos del libro.

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

En el ejemplo se usa el archivo , 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>

Comentarios

Los nodos se colocan en el orden en el que se encontrarían en un recorrido de orden previo del XmlElement árbol.

Note

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

Se aplica a