XmlDocument.GetElementsByTagName Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve un XmlNodeList objeto que contiene una lista de todos los elementos descendientes que coinciden con el nombre especificado.
Sobrecargas
| Nombre | Description |
|---|---|
| GetElementsByTagName(String) |
Devuelve un XmlNodeList objeto que contiene una lista de todos los elementos descendientes que coinciden con el especificado Name. |
| 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)
- Source:
- XmlDocument.cs
- Source:
- XmlDocument.cs
- Source:
- XmlDocument.cs
- Source:
- XmlDocument.cs
- Source:
- XmlDocument.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
Nombre completo que se va a coincidir. Coincide con la Name propiedad del nodo coincidente. El valor especial "*" coincide con todas las etiquetas.
Devoluciones
que XmlNodeList contiene una lista de todos los nodos coincidentes. Si no hay nodos que coincidan namecon , la colección devuelta estará 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;
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 usa el books.xml archivo como entrada.
<?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.
Note
Se recomienda usar el XmlNode.SelectNodes método o XmlNode.SelectSingleNode en lugar del GetElementsByTagName método .
Se aplica a
GetElementsByTagName(String, String)
- Source:
- XmlDocument.cs
- Source:
- XmlDocument.cs
- Source:
- XmlDocument.cs
- Source:
- XmlDocument.cs
- Source:
- XmlDocument.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
LocalName que se va a buscar. El valor especial "*" coincide con todas las etiquetas.
- namespaceURI
- String
NamespaceURI para que coincida.
Devoluciones
que XmlNodeList contiene una lista de todos los nodos coincidentes. Si ningún nodo coincide con el especificado localName y namespaceURI, la colección devuelta estará vacía.
Comentarios
Los nodos se colocan en el orden en el que se encontrarían en el árbol de documentos.
Note
Se recomienda usar el XmlNode.SelectNodes método o XmlNode.SelectSingleNode en lugar del GetElementsByTagName método .