XmlDocument.GetElementsByTagName XmlDocument.GetElementsByTagName XmlDocument.GetElementsByTagName XmlDocument.GetElementsByTagName Method

Definición

Devuelve un objeto XmlNodeList que contiene una lista de todos los elementos descendientes que coinciden con el nombre especificado.Returns an XmlNodeList containing a list of all descendant elements that match the specified name.

Sobrecargas

GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String)

Devuelve un objeto XmlNodeList que contiene una lista de todos los elementos descendientes que coinciden con el Name especificado.Returns an XmlNodeList containing a list of all descendant elements that match the specified Name.

GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String)

Devuelve un objeto XmlNodeList que contiene una lista de todos los elementos descendientes que coinciden con el LocalName y NamespaceURI especificados.Returns an XmlNodeList containing a list of all descendant elements that match the specified LocalName and NamespaceURI.

GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String)

Devuelve un objeto XmlNodeList que contiene una lista de todos los elementos descendientes que coinciden con el Name especificado.Returns an XmlNodeList containing a list of all descendant elements that match the specified 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 String String String

Nombre completo que se va a hacer coincidir.The qualified name to match. Se compara con la propiedad Name del nodo coincidente.It is matched against the Name property of the matching node. El valor especial "*" coincide con todas las etiquetas.The special value "*" matches all tags.

Devoluciones

Objeto XmlNodeList que contiene una lista de todos los nodos coincidentes.An XmlNodeList containing a list of all matching nodes. Si ningún nodo coincide con name, se devolverá la colección vacía.If no nodes match name, the returned collection will be empty.

Ejemplos

En el ejemplo siguiente se XmlDocument crea un objeto y GetElementsByTagName se usa el método XmlNodeList y el objeto resultante para mostrar todos los títulos de libros.The following example creates a XmlDocument object and uses the GetElementsByTagName method and the resulting XmlNodeList object to display all the book titles.

#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.IO;
using System.Xml;

public class Sample
{
  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.The example uses the books.xml file as input.

<?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 el que se encontrarían en el documento.The nodes are placed in the order in which they would be encountered in the document.

Nota

Se recomienda utilizar el XmlNode.SelectNodes XmlNode.SelectSingleNode método o en lugar del método.GetElementsByTagNameIt is recommended that you use the XmlNode.SelectNodes or XmlNode.SelectSingleNode method instead of the GetElementsByTagName method.

GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String)

Devuelve un objeto XmlNodeList que contiene una lista de todos los elementos descendientes que coinciden con el LocalName y NamespaceURI especificados.Returns an XmlNodeList containing a list of all descendant elements that match the specified LocalName and 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 String String String

Nombre local que se va a hacer coincidir.The LocalName to match. El valor especial "*" coincide con todas las etiquetas.The special value "*" matches all tags.

namespaceURI
String String String String

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

Devoluciones

Objeto XmlNodeList que contiene una lista de todos los nodos coincidentes.An XmlNodeList containing a list of all matching nodes. Si ningún nodo coincide con el localName y namespaceURI especificados, se devolverá la colección vacía.If no nodes match the specified localName and namespaceURI, the returned collection will be empty.

Comentarios

Los nodos se colocan en el orden en el que se encontrarían en el árbol del documento.The nodes are placed in the order in which they would be encountered in the document tree.

Nota

Se recomienda utilizar el XmlNode.SelectNodes XmlNode.SelectSingleNode método o en lugar del método.GetElementsByTagNameIt is recommended that you use the XmlNode.SelectNodes or XmlNode.SelectSingleNode method instead of the GetElementsByTagName method.

Se aplica a