Partager via


Accès aux attributs dans le DOM

Les attributs sont des propriétés de l'élément, pas des enfants de l'élément. Cette distinction est importante en raison des méthodes utilisées pour accéder aux nœuds frères, parents et enfants du DOM (Document Object Model) XML. Par exemple, les méthodes PreviousSibling et NextSibling ne sont pas utilisées pour naviguer d'un élément à un attribut ou entre des attributs. À la place, un attribut est une propriété d'un élément et appartient à un élément, cet attribut possède une propriété OwnerElement et pas de propriété parentNode, il possède des méthodes distinctes de navigation.

Si le nœud en cours est un élément, utilisez la méthode HasAttribute pour vérifier si des attributs sont associés à l'élément. Une fois que vous savez qu'un élément possède des attributs, il existe plusieurs méthodes permettant d'accéder à des attributs. Pour extraire un seul attribut de l'élément, vous pouvez utiliser les méthodes GetAttribute et GetAttributeNode de XmlElement ou bien obtenir tous les attributs dans une collection. L'obtention de la collection est utile s'il est nécessaire d'itérer sur la collection. Si vous voulez tous les attributs de l'élément, utilisez la propriété Attributes de l'élément pour extraire tous les attributs d'une collection.

Extraction de tous les attributs d'une collection

Si vous voulez que tous les attributs d'un nœud d'élément soient insérés dans une collection, appelez la propriété XmlElement.Attributes. Cette dernière obtient le XmlAttributeCollection qui contient tous les attributs de l'élément. La classe XmlAttributeCollection hérite de la table XmlNamedNode. Par conséquent, les méthodes et propriétés disponibles sur la collection comprennent celles qui sont disponibles sur une table de nœud nommée, en plus des méthodes et propriétés spécifiques à la classe XmlAttributeCollection comme la propriété ItemOf ou la méthode Append. Chaque élément de la collection d'attributs représente un nœud XmlAttribute. Pour connaître le nombre d'attributs appliqués à un élément, obtenez XmlAttributeCollection, puis utilisez la propriété Count pour dénombrer les nœuds XmlAttribute que contient la collection.

L'exemple de code suivant montre comment extraire une collection d'attributs et, à l'aide de la méthode Count pour l'index de boucle, comment itérer sur cette collection. Le code montre ensuite comment extraire un attribut unique de la collection et afficher sa valeur.

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample

    Public Shared Sub Main()

        Dim doc As XmlDocument = New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5' misc='sale item'>" & _
               "<title>The Handmaid's Tale</title>" & _
               "<price>14.95</price>" & _
               "</book>")

        ' Move to an element. 
        Dim myElement As XmlElement = doc.DocumentElement

        ' Create an attribute collection from the element.
        Dim attrColl As XmlAttributeCollection = myElement.Attributes

        ' Show the collection by iterating over it.
        Console.WriteLine("Display all the attributes in the collection...")
        Dim i As Integer
        For i = 0 To attrColl.Count - 1
            Console.Write("{0} = ", attrColl.ItemOf(i).Name)
            Console.Write("{0}", attrColl.ItemOf(i).Value)
            Console.WriteLine()
        Next

        ' Retrieve a single attribute from the collection; specifically, the
        ' attribute with the name "misc".
        Dim attr As XmlAttribute = attrColl("misc")

        ' Retrieve the value from that attribute.
        Dim miscValue As String = attr.InnerXml

        Console.WriteLine("Display the attribute information.")
        Console.WriteLine(miscValue)

    End Sub
End Class
using System;
using System.IO;
using System.Xml;

public class Sample
{

    public static void Main()
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5' misc='sale item'>" +
                      "<title>The Handmaid's Tale</title>" +
                      "<price>14.95</price>" +
                      "</book>");

        // Move to an element.
        XmlElement myElement = doc.DocumentElement;

        // Create an attribute collection from the element.
        XmlAttributeCollection attrColl = myElement.Attributes;

        // Show the collection by iterating over it.
        Console.WriteLine("Display all the attributes in the collection...");
        for (int i = 0; i < attrColl.Count; i++)
        {
            Console.Write("{0} = ", attrColl[i].Name);
            Console.Write("{0}", attrColl[i].Value);
            Console.WriteLine();
        }

        // Retrieve a single attribute from the collection; specifically, the
        // attribute with the name "misc".
        XmlAttribute attr = attrColl["misc"];

        // Retrieve the value from that attribute.
        String miscValue = attr.InnerXml;

        Console.WriteLine("Display the attribute information.");
        Console.WriteLine(miscValue);

    }
}

Cet exemple affiche la sortie suivante :

Output

Afficher tous les attributs dans la collection.

genre = novel
ISBN = 1-861001-57-5
misc = sale item
Display the attribute information.
sale item

Les informations d'une collection d'attributs peuvent être extraites par leur nom ou numéro d'index. L'exemple ci-avant montre comment extraire des données par nom. L'exemple suivant montre comment extraire des données par numéro d'index.

Comme XmlAttributeCollection est une collection et peut faire l'objet d'itération par nom ou index, cet exemple illustre l'extraction du premier attribut dans la collection à l'aide d'un index de base zéro et l'utilisation du fichier suivant, baseuri.xml comme entrée.

Entrée

<!-- XML fragment -->
<book genre="novel">
  <title>Pride And Prejudice</title>
</book>
Option Explicit On
Option Strict On

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample

    Public Shared Sub Main()
        ' Create the XmlDocument.
        Dim doc As New XmlDocument()
        doc.Load("https://localhost/baseuri.xml")

        ' Display information on the attribute node. The value
        ' returned for BaseURI is 'https://localhost/baseuri.xml'.
        Dim attr As XmlAttribute = doc.DocumentElement.Attributes(0)
        Console.WriteLine("Name of the attribute:  {0}", attr.Name)
        Console.WriteLine("Base URI of the attribute:  {0}", attr.BaseURI)
        Console.WriteLine("The value of the attribtue:  {0}", attr.InnerText)
    End Sub 'Main 
End Class 'Sample
using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    // Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    
    doc.Load("https://localhost/baseuri.xml");
                     
    // Display information on the attribute node. The value
    // returned for BaseURI is 'https://localhost/baseuri.xml'.
    XmlAttribute attr = doc.DocumentElement.Attributes[0];
    Console.WriteLine("Name of the attribute:  {0}", attr.Name);
    Console.WriteLine("Base URI of the attribute:  {0}", attr.BaseURI);
    Console.WriteLine("The value of the attribtue:  {0}", attr.InnerText);
  }
}

Extraction d'un nœud d'attribut individuel

Pour extraire un seul nœud d'attribut d'un élément, la méthode XmlElement.GetAttributeNode est utilisée. Elle retourne un objet de type XmlAttribute. Une fois que vous disposez de XmlAttribute, toutes les méthodes et propriétés disponibles dans la classe de membres XmlAttribute sont disponibles sur cet objet, comme la recherche de OwnerElement.

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample

    Public Shared Sub Main()

        Dim doc As XmlDocument = New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5' misc='sale item'>" & _
               "<title>The Handmaid's Tale</title>" & _
               "<price>14.95</price>" & _
               "</book>")

        ' Move to an element.
        Dim root As XmlElement
        root = doc.DocumentElement

        ' Get an attribute.
        Dim attr As XmlAttribute
        attr = root.GetAttributeNode("ISBN")

        ' Display the value of the attribute.
        Dim attrValue As String
        attrValue = attr.InnerXml
        Console.WriteLine(attrValue)

    End Sub
End Class
using System;
using System.IO;
using System.Xml;
 
 public class Sample
 {
      public static void Main()
      {
    XmlDocument doc = new XmlDocument();
     doc.LoadXml("<book genre='novel' ISBN='1-861003-78' misc='sale item'>" +
                   "<title>The Handmaid's Tale</title>" +
                   "<price>14.95</price>" +
                   "</book>"); 

    // Move to an element.
     XmlElement root = doc.DocumentElement;
   
    // Get an attribute.
     XmlAttribute attr = root.GetAttributeNode("ISBN");
  
    // Display the value of the attribute.
     String attrValue = attr.InnerXml;
     Console.WriteLine(attrValue);

    }
}

Vous pouvez également suivre l'exemple précédent, où un nœud d'attribut unique est extrait de la collection d'attributs. L'exemple de code suivant montre comment il est possible d'écrire une ligne de code pour extraire un attribut unique par numéro d'index depuis la racine d'une arborescence de document XML, également connue sous le nom de propriété DocumentElement.

XmlAttribute attr = doc.DocumentElement.Attributes[0];

Voir aussi

Concepts

DOM (Document Object Model) XML