XmlElement.GetElementsByTagName Méthode

  • Référence

Définition

Espace de noms:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Retourne un élément XmlNodeList contenant la liste de tous les éléments descendants qui correspondent au nom spécifié.

Surcharges

GetElementsByTagName(String, String)

Retourne un élément XmlNodeList contenant la liste de tous les éléments descendants qui correspondent aux éléments LocalName et NamespaceURI spécifiés.
GetElementsByTagName(String)

Retourne un élément XmlNodeList contenant la liste de tous les éléments descendants qui correspondent à l'élément Name spécifié.

GetElementsByTagName(String, String)

Source:
XmlElement.cs
Source:
XmlElement.cs
Source:
XmlElement.cs

Retourne un élément XmlNodeList contenant la liste de tous les éléments descendants qui correspondent aux éléments LocalName et NamespaceURI spécifiés.

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

Paramètres

localName
String

Nom local à mettre en correspondance. L’astérisque (*) est une valeur spéciale qui correspond à toutes les balises.

namespaceURI
String

URI de l'espace de noms à mettre en correspondance.

Retours

XmlNodeList

Un élément XmlNodeList contenant la liste de tous les nœuds correspondants. La liste est vide s’il n’existe aucun nœud correspondant.

Remarques

Les nœuds sont placés dans l’ordre dans lequel ils seraient rencontrés dans un parcours de précommande de l’arborescence XmlElement .

Notes

Il est recommandé d’utiliser la XmlNode.SelectNodes méthode ou XmlNode.SelectSingleNode au lieu de la GetElementsByTagName méthode .

S’applique à

GetElementsByTagName(String)

Source:
XmlElement.cs
Source:
XmlElement.cs
Source:
XmlElement.cs

Retourne un élément XmlNodeList contenant la liste de tous les éléments descendants qui correspondent à l'élément Name spécifié.

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

Paramètres

name
String

Balise de nom à mettre en correspondance. Il s’agit d’un nom qualifié. Il est comparé à la propriété Name du nœud correspondant. L’astérisque (*) est une valeur spéciale qui correspond à toutes les balises.

Retours

XmlNodeList

Un élément XmlNodeList contenant la liste de tous les nœuds correspondants. La liste est vide s’il n’existe aucun nœud correspondant.

Exemples

L’exemple suivant obtient et affiche tous les titres des livres.

#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

L’exemple utilise le fichier , 2books.xmlcomme entrée.

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

Remarques

Les nœuds sont placés dans l’ordre dans lequel ils seraient rencontrés dans un parcours de précommande de l’arborescence XmlElement .

Notes

Il est recommandé d’utiliser la XmlNode.SelectNodes méthode ou XmlNode.SelectSingleNode au lieu de la GetElementsByTagName méthode .

S’applique à