XmlDocument.GetElementsByTagName Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna uma XmlNodeList lista contendo todos os elementos descendentes que correspondem ao nome especificado.
Sobrecargas
| Nome | Description |
|---|---|
| GetElementsByTagName(String) |
Retorna uma XmlNodeList lista contendo todos os elementos descendentes que correspondem ao especificado Name. |
| GetElementsByTagName(String, String) |
Retorna uma XmlNodeList lista contendo todos os elementos descendentes que correspondem ao especificado LocalName e NamespaceURI. |
GetElementsByTagName(String)
- Origem:
- XmlDocument.cs
- Origem:
- XmlDocument.cs
- Origem:
- XmlDocument.cs
- Origem:
- XmlDocument.cs
- Origem:
- XmlDocument.cs
Retorna uma XmlNodeList lista contendo todos os elementos descendentes que correspondem ao 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
O nome qualificado a ser correspondido. Ele é correspondido com a Name propriedade do nó correspondente. O valor especial "*" corresponde a todas as marcas.
Retornos
Uma XmlNodeList lista contendo todos os nós correspondentes. Se nenhum nó corresponder name, a coleção retornada estará vazia.
Exemplos
O exemplo a seguir cria um XmlDocument objeto e usa o GetElementsByTagName método e o objeto resultante XmlNodeList para exibir todos os títulos do livro.
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
O exemplo usa o books.xml arquivo 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>
Comentários
Os nós são colocados na ordem em que seriam encontrados no documento.
Note
É recomendável que você use o método ou XmlNode.SelectNodes o XmlNode.SelectSingleNode método em vez do GetElementsByTagName método.
Aplica-se a
GetElementsByTagName(String, String)
- Origem:
- XmlDocument.cs
- Origem:
- XmlDocument.cs
- Origem:
- XmlDocument.cs
- Origem:
- XmlDocument.cs
- Origem:
- XmlDocument.cs
Retorna uma XmlNodeList lista contendo todos os elementos descendentes que correspondem ao especificado LocalName e 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
O LocalName a ser correspondido. O valor especial "*" corresponde a todas as marcas.
- namespaceURI
- String
NamespaceURI a ser correspondido.
Retornos
Uma XmlNodeList lista contendo todos os nós correspondentes. Se nenhum nó corresponder ao especificado e localNamea coleção retornada namespaceURI estiver vazia.
Comentários
Os nós são colocados na ordem em que seriam encontrados na árvore de documentos.
Note
É recomendável que você use o método ou XmlNode.SelectNodes o XmlNode.SelectSingleNode método em vez do GetElementsByTagName método.