XmlElement.GetElementsByTagName Méthode

Définition

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

Retourne une XmlNodeList liste de tous les éléments descendants qui correspondent au nom spécifié.

Surcharges

Nom Description
GetElementsByTagName(String, String)

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

Retourne une XmlNodeList liste de tous les éléments descendants qui correspondent à l’élément spécifié Name.

GetElementsByTagName(String, String)

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

Retourne une XmlNodeList liste de tous les éléments descendants qui correspondent aux éléments spécifiés LocalName et 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

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 d’espace de noms à mettre en correspondance.

Retours

XmlNodeList

Contenant XmlNodeList une 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 une traversée de précommande de l’arborescence XmlElement .

Note

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

S’applique à

GetElementsByTagName(String)

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

Retourne une XmlNodeList liste de tous les éléments descendants qui correspondent à l’élément spécifié 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

Paramètres

name
String

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

Retours

XmlNodeList

Contenant XmlNodeList une 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 du livre.

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 une traversée de précommande de l’arborescence XmlElement .

Note

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

S’applique à