XmlDocument.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)

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

Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.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

Nom qualifié à mettre en correspondance. Il est mis en correspondance avec la Name propriété du nœud correspondant. La valeur spéciale « * » correspond à toutes les balises.

Retours

XmlNodeList

Contenant XmlNodeList une liste de tous les nœuds correspondants. Si aucun nœud ne correspond name, la collection retournée est vide.

Exemples

L’exemple suivant crée un XmlDocument objet et utilise la GetElementsByTagName méthode et l’objet résultant XmlNodeList pour afficher tous les titres du livre.

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

L’exemple utilise le books.xml fichier comme entrée.

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

Remarques

Les nœuds sont placés dans l’ordre dans lequel ils seraient rencontrés dans le document.

Note

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

S’applique à

GetElementsByTagName(String, String)

Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.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

LocalName à mettre en correspondance. La valeur spéciale « * » correspond à toutes les balises.

namespaceURI
String

NamespaceURI à mettre en correspondance.

Retours

XmlNodeList

Contenant XmlNodeList une liste de tous les nœuds correspondants. Si aucun nœud ne correspond à l’élément spécifié localName et namespaceURIque la collection retournée est vide.

Remarques

Les nœuds sont placés dans l’ordre dans lequel ils seraient rencontrés dans l’arborescence de documents.

Note

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

S’applique à