XmlDocument.GetElementsByTagName Méthode

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

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é à trouver. Il est comparé à la propriété Name du nœud correspondant. La valeur spéciale "*" correspond à toutes les étiquettes.

Retours

XmlNodeList

Un élément XmlNodeList contenant la liste de tous les nœuds correspondants. Si aucun nœud ne correspond à name, la collection retournée sera 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.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew 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 );
   }
}

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 prend le fichier books.xml 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 seront rencontrés dans le document.

Notes

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

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.

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 à trouver. La valeur spéciale "*" correspond à toutes les étiquettes.

namespaceURI

String

URI d'espace de noms avec lequel établir une correspondance.

Retours

XmlNodeList

Un élément XmlNodeList contenant la liste de tous les nœuds correspondants. Si aucun nœud ne correspond aux éléments localName et namespaceURI spécifiés, la collection retournée sera vide.

Remarques

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

Notes

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