XmlDocument.GetElementsByTagName Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.XmlDocument.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Restituisce un oggetto XmlNodeList contenente un elenco di tutti gli elementi discendenti che corrispondono al nome specificato.

Overload

GetElementsByTagName(String)	Restituisce un oggetto XmlNodeList contenente un elenco di tutti gli elementi discendenti che corrispondono alla proprietà Name specificata.
GetElementsByTagName(String, String)	Restituisce un oggetto XmlNodeList contenente un elenco di tutti gli elementi discendenti che corrispondono alle proprietà LocalName e NamespaceURI specificate.

GetElementsByTagName(String)

Restituisce un oggetto XmlNodeList contenente un elenco di tutti gli elementi discendenti che corrispondono alla proprietà Name specificata.

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

Parametri

name

String

Nome completo di cui verificare la corrispondenza. Viene confrontato con la proprietà Name del nodo corrispondente. Il valore speciale "*" corrisponde a tutti i tag.

Restituisce

XmlNodeList

Oggetto XmlNodeList contenente un elenco di tutti i nodi corrispondenti. Se nessun nodo corrisponde a name, la raccolta restituita sarà vuota.

Esempio

Nell'esempio seguente viene creato un XmlDocument oggetto e viene usato il metodo e l'oggetto GetElementsByTagName risultante XmlNodeList per visualizzare tutti i titoli del libro.

#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.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

Nell'esempio viene utilizzato il file books.xml come 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>

Commenti

I nodi vengono inseriti nell'ordine in cui verranno rilevati nel documento.

Nota

È consigliabile usare il XmlNode.SelectNodes metodo o XmlNode.SelectSingleNode anziché il GetElementsByTagName metodo.

GetElementsByTagName(String, String)

Restituisce un oggetto XmlNodeList contenente un elenco di tutti gli elementi discendenti che corrispondono alle proprietà LocalName e NamespaceURI specificate.

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

Parametri

localName

String

LocalName di cui verificare la corrispondenza. Il valore speciale "*" corrisponde a tutti i tag.

namespaceURI

String

NamespaceURI di cui verificare la corrispondenza.

Restituisce

XmlNodeList

Oggetto XmlNodeList contenente un elenco di tutti i nodi corrispondenti. Se nessun nodo corrisponde agli oggetti localName e namespaceURI specificati, la raccolta restituita sarà vuota.

Commenti

I nodi vengono inseriti nell'ordine in cui verranno rilevati nell'albero dei documenti.

Nota

È consigliabile usare il XmlNode.SelectNodes metodo o XmlNode.SelectSingleNode anziché il GetElementsByTagName metodo.