Accès aux attributs dans le DOM
Mise à jour : November 2007
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];