XmlElement.GetElementsByTagName Metodo

Definizione

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

Overload

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.

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

Nome locale di cui verificare la corrispondenza. L'asterisco (*) è un valore speciale che corrisponde a tutti i tag.

namespaceURI
String

URI dello spazio dei nomi da associare.

Restituisce

Oggetto XmlNodeList contenente un elenco di tutti i nodi corrispondenti. Se non sono presenti nodi corrispondenti, l'elenco sarà vuoto.

Commenti

I nodi vengono inseriti nell'ordine in cui verrebbero rilevati in un attraversamento preordinato dell'albero XmlElement .

Nota

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

Si applica a

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

Tag del nome da confrontare. Si tratta di un nome completo. Viene confrontato con la proprietà Name del nodo corrispondente. L'asterisco (*) è un valore speciale che corrisponde a tutti i tag.

Restituisce

Oggetto XmlNodeList contenente un elenco di tutti i nodi corrispondenti. Se non sono presenti nodi corrispondenti, l'elenco sarà vuoto.

Esempio

L'esempio seguente ottiene e visualizza tutti i titoli 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

Nell'esempio viene usato il file , 2books.xml, come input.

<!--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>

Commenti

I nodi vengono inseriti nell'ordine in cui verrebbero rilevati in un attraversamento preordinato dell'albero XmlElement .

Nota

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

Si applica a