XmlElement.GetElementsByTagName Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

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

Sobrecargas

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.

GetElementsByTagName(String, String)

Source:

XmlElement.cs

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 asterisco (*) es un valor especial que coincide con todas las etiquetas.

namespaceURI

String

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

Devoluciones

XmlNodeList

Objeto XmlNodeList que 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 que se encontrarían en un recorrido preordenado del XmlElement árbol.

Nota:

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

GetElementsByTagName(String)

Source:

XmlElement.cs

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

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

Devoluciones

XmlNodeList

Objeto XmlNodeList que 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.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

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 que se encontrarían en un recorrido preordenado del XmlElement árbol.

Nota

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