XmlElement.GetElementsByTagName Metodo

Definizione

Restituisce un oggetto XmlNodeList contenente un elenco di tutti gli elementi discendenti che corrispondono al nome specificato.Returns an XmlNodeList containing a list of all descendant elements that match the specified name.

Overload

GetElementsByTagName(String, String)

Restituisce un oggetto XmlNodeList contenente un elenco di tutti gli elementi discendenti che corrispondono alle proprietà LocalName e NamespaceURI specificate.Returns an XmlNodeList containing a list of all descendant elements that match the specified LocalName and NamespaceURI.

GetElementsByTagName(String)

Restituisce un oggetto XmlNodeList contenente un elenco di tutti gli elementi discendenti che corrispondono alla proprietà Name specificata.Returns an XmlNodeList containing a list of all descendant elements that match the specified Name.

GetElementsByTagName(String, String)

Restituisce un oggetto XmlNodeList contenente un elenco di tutti gli elementi discendenti che corrispondono alle proprietà LocalName e NamespaceURI specificate.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

Parametri

localName
String

Nome locale di cui verificare la corrispondenza.The local name to match. L'asterisco (*) è un valore speciale che corrisponde a tutti i tag.The asterisk (*) is a special value that matches all tags.

namespaceURI
String

URI dello spazio dei nomi da associare.The namespace URI to match.

Restituisce

Oggetto XmlNodeList contenente un elenco di tutti i nodi corrispondenti.An XmlNodeList containing a list of all matching nodes. Se non sono presenti nodi corrispondenti, l'elenco sarà vuoto.The list is empty if there are no matching nodes.

Commenti

I nodi vengono posizionati nell'ordine in cui verrebbero rilevati in un attraversamento preordinato della struttura ad albero XmlElement.The nodes are placed in the order in which they would be encountered in a preorder traversal of the XmlElement tree.

Nota

È consigliabile usare il metodo XmlNode.SelectNodes o XmlNode.SelectSingleNode anziché il metodo GetElementsByTagName.It is recommended that you use the XmlNode.SelectNodes or XmlNode.SelectSingleNode method instead of the GetElementsByTagName method.

GetElementsByTagName(String)

Restituisce un oggetto XmlNodeList contenente un elenco di tutti gli elementi discendenti che corrispondono alla proprietà Name specificata.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

Parametri

name
String

Tag del nome da confrontare.The name tag to match. Si tratta di un nome completo.This is a qualified name. Viene confrontato con la proprietà Name del nodo corrispondente.It is matched against the Name property of the matching node. L'asterisco (*) è un valore speciale che corrisponde a tutti i tag.The asterisk (*) is a special value that matches all tags.

Restituisce

Oggetto XmlNodeList contenente un elenco di tutti i nodi corrispondenti.An XmlNodeList containing a list of all matching nodes. Se non sono presenti nodi corrispondenti, l'elenco sarà vuoto.The list is empty if there are no matching nodes.

Esempi

Nell'esempio seguente vengono recuperati e visualizzati tutti i titoli dei libri.The following example gets and displays all the book titles.

#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.xmlcome input.The example uses the file, 2books.xml, as 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 posizionati nell'ordine in cui verrebbero rilevati in un attraversamento preordinato della struttura ad albero XmlElement.The nodes are placed in the order in which they would be encountered in a preorder traversal of the XmlElement tree.

Nota

È consigliabile usare il metodo XmlNode.SelectNodes o XmlNode.SelectSingleNode anziché il metodo GetElementsByTagName.It is recommended that you use the XmlNode.SelectNodes or XmlNode.SelectSingleNode method instead of the GetElementsByTagName method.

Si applica a