XmlNode.SelectNodes Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Sélectionne une liste de nœuds correspondant à l'expression XPath.

Surcharges

SelectNodes(String)	Sélectionne une liste de nœuds correspondant à l'expression XPath.
SelectNodes(String, XmlNamespaceManager)	Sélectionne une liste de nœuds correspondant à l'expression XPath. Tous les préfixes trouvés dans l'expression XPath sont résolus à l'aide du XmlNamespaceManager fourni.

Remarques

Les expressions XPath peuvent inclure des espaces de noms. La résolution d'espace de noms n'est pas prise en charge par l'objet XmlNamespaceManager. Si l’expression XPath inclut un préfixe, le préfixe et la paire URI d’espace de noms doivent être ajoutés à .XmlNamespaceManager

Remarque

Si l’expression XPath n’inclut pas de préfixe, il est supposé que l’URI de l’espace de noms est l’espace de noms vide. Si votre code XML inclut un espace de noms par défaut, vous devez toujours ajouter un préfixe et un URI d’espace de noms à ; XmlNamespaceManagersinon, vous n’obtiendrez aucun nœud sélectionné.

Pour plus d’informations, consultez Sélectionner des nœuds à l’aide de la navigation XPath. Pour obtenir des exemples de code, choisissez une surcharge dans la liste des surcharges de la section précédente.

SelectNodes(String)

Source:

XmlNode.cs

Sélectionne une liste de nœuds correspondant à l'expression XPath.

C#

public System.Xml.XmlNodeList? SelectNodes (string xpath);

Paramètres

xpath

String

Expression XPath.

Retours

XmlNodeList

XmlNodeList contenant une collection de nœuds correspondant à la requête XPath.

Exceptions

XPathException

L'expression XPath contient un préfixe. Consultez Exemples de XPath.

Exemples

L’exemple suivant sélectionne tous les livres dont le nom de l’auteur est Austen, puis modifie le prix de ces livres.

C#

using System;
using System.Xml;

public class Sample6
{
    public static void Main()
    {
        XmlDocument doc = new XmlDocument();
        doc.Load("booksort.xml");

        XmlNodeList nodeList;
        XmlNode root = doc.DocumentElement;

        nodeList = root.SelectNodes("descendant::book[author/last-name='Austen']");

        //Change the price on the books.
        foreach (XmlNode book in nodeList)
        {
            book.LastChild.InnerText = "15.95";
        }

        Console.WriteLine("Display the modified XML document....");
        doc.Save(Console.Out);
    }
}

Cet exemple utilise le code XML suivant :

XML

<?xml version="1.0"?>
<!-- A fragment of a book store inventory database -->
<bookstore xmlns:bk="urn:samples">
  <book genre="novel" publicationdate="1997" bk:ISBN="1-861001-57-8">
    <title>Pride And Prejudice</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>24.95</price>
  </book>
  <book genre="novel" publicationdate="1992" bk:ISBN="1-861002-30-1">
    <title>The Handmaid's Tale</title>
    <author>
      <first-name>Margaret</first-name>
      <last-name>Atwood</last-name>
    </author>
    <price>29.95</price>
  </book>
  <book genre="novel" publicationdate="1991" bk:ISBN="1-861001-57-6">
    <title>Emma</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
  <book genre="novel" publicationdate="1982" bk:ISBN="1-861001-45-3">
    <title>Sense and Sensibility</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
</bookstore>

Remarques

Si l’expression XPath nécessite une résolution d’espace de noms, vous devez utiliser la SelectNodes surcharge qui prend un XmlNamespaceManager comme argument. le XmlNamespaceManager est utilisé pour résoudre les espaces de noms.

Remarque

Si l’expression XPath n’inclut pas de préfixe, il est supposé que l’URI de l’espace de noms est l’espace de noms vide. Si votre code XML inclut un espace de noms par défaut, vous devez toujours utiliser et XmlNamespaceManager y ajouter un préfixe et un URI d’espace de noms ; sinon, vous n’obtiendrez aucun nœud sélectionné. Pour plus d’informations, consultez Sélectionner des nœuds à l’aide de la navigation XPath.

Remarque

Un problème courant lors de la formulation d’expressions XPath est d’inclure un guillemet simple (') ou un guillemet double (") dans l’expression. Si vous devez rechercher une valeur qui inclut un guillemet unique, vous devez placer la chaîne entre guillemets doubles. Si vous devez rechercher une valeur qui inclut un guillemet double, vous devez placer la chaîne entre guillemets simples.

Par exemple, supposons que vous ayez le code XML suivant :

XML

<bookstore>
  <book>
    <title>&apos;Emma&apos;</title>
  </book>
</bookstore>

Le code Visual Basic suivant sélectionne un élément qui contient des guillemets simples :

C#

nodeList = root.SelectNodes("//book[contains(title,""'Emma'"")]")

Cette méthode est une extension Microsoft du DOM (Document Object Model).

L’objet XmlNodeList retourné par cette méthode sera valide tant que le document sous-jacent reste inchangé. Si le document sous-jacent change, des résultats inattendus peuvent être retournés (aucune exception ne sera levée).

Voir aussi

• SelectSingleNode(String)
• Sélections XPath et fonctions personnalisées, etc.
• Recommandation W3C XPath 1.0

SelectNodes(String, XmlNamespaceManager)

Source:

XmlNode.cs

Sélectionne une liste de nœuds correspondant à l'expression XPath. Tous les préfixes trouvés dans l'expression XPath sont résolus à l'aide du XmlNamespaceManager fourni.

C#

public System.Xml.XmlNodeList? SelectNodes (string xpath, System.Xml.XmlNamespaceManager nsmgr);

Paramètres

xpath

String

Expression XPath. Consultez Exemples de XPath.

nsmgr

XmlNamespaceManager

XmlNamespaceManager à utiliser pour résoudre les espaces de noms des préfixes dans l'expression XPath.

Retours

XmlNodeList

XmlNodeList contenant une collection de nœuds correspondant à la requête XPath.

Exceptions

XPathException

L'expression XPath contient un préfixe qui n'est pas défini dans XmlNamespaceManager.

Exemples

L’exemple suivant affiche les valeurs de chacun des attributs ISBN. Cet exemple utilise un XmlElement objet, qui hérite de la XmlNode classe .

C#

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

      XmlDocument doc = new XmlDocument();
      doc.Load("booksort.xml");

      //Create an XmlNamespaceManager for resolving namespaces.
      XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);
      nsmgr.AddNamespace("bk", "urn:samples");

      //Select and display the value of all the ISBN attributes.
      XmlNodeList nodeList;
      XmlElement root = doc.DocumentElement;
      nodeList = root.SelectNodes("/bookstore/book/@bk:ISBN", nsmgr);
      foreach (XmlNode isbn in nodeList){
        Console.WriteLine(isbn.Value);
      }
   }
}

L’exemple utilise le fichier , booksort.xmlcomme entrée.

XML

<?xml version="1.0"?>
<!-- A fragment of a book store inventory database -->
<bookstore xmlns:bk="urn:samples">
  <book genre="novel" publicationdate="1997" bk:ISBN="1-861001-57-8">
    <title>Pride And Prejudice</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>24.95</price>
  </book>
  <book genre="novel" publicationdate="1992" bk:ISBN="1-861002-30-1">
    <title>The Handmaid's Tale</title>
    <author>
      <first-name>Margaret</first-name>
      <last-name>Atwood</last-name>
    </author>
    <price>29.95</price>
  </book>
  <book genre="novel" publicationdate="1991" bk:ISBN="1-861001-57-6">
    <title>Emma</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
  <book genre="novel" publicationdate="1982" bk:ISBN="1-861001-45-3">
    <title>Sense and Sensibility</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
</bookstore>

Remarques

Les expressions XPath peuvent inclure des espaces de noms. La résolution d'espace de noms n'est pas prise en charge par l'objet XmlNamespaceManager. Si l’expression XPath inclut un préfixe, le préfixe et la paire URI d’espace de noms doivent être ajoutés à .XmlNamespaceManager

Remarque

Si l’expression XPath n’inclut pas de préfixe, il est supposé que l’URI de l’espace de noms est l’espace de noms vide. Si votre code XML inclut un espace de noms par défaut, vous devez toujours ajouter un préfixe et un URI d’espace de noms à ; XmlNamespaceManagersinon, vous n’obtiendrez aucun nœud sélectionné. Pour plus d’informations, consultez Sélectionner des nœuds à l’aide de la navigation XPath.

Par exemple, si vous aviez le code XML suivant :

XML

<bookstore xmlns="http://www.lucernepublishing.com">
 <book>
   <title>Pride And Prejudice</title>
 </book>
</bookstore>

Le code C# suivant sélectionne tous les nœuds de livre :

C#

XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);
nsmgr.AddNamespace("ab", "http://www.lucernepublishing.com");
XmlNodeList nodelist = doc.SelectNodes("//ab:book", nsmgr);

Remarque

Un problème courant lors de la formulation d’expressions XPath est d’inclure un guillemet simple (') ou un guillemet double (") dans l’expression. Si vous devez rechercher une valeur qui inclut un guillemet unique, vous devez placer la chaîne entre guillemets doubles. Si vous devez rechercher une valeur qui inclut un guillemet double, vous devez placer la chaîne entre guillemets simples.

Par exemple, supposons que vous ayez le code XML suivant :

XML

<bookstore xmlns="http://www.lucernepublishing.com">
  <book>
    <title>&apos;Emma&apos;</title>
  </book>
</bookstore>

Le code Visual Basic suivant sélectionne un élément qui contient des guillemets simples :

VB

Dim nsmgr As XmlNamespaceManager = New XmlNamespaceManager(doc.NameTable)
nsmgr.AddNamespace("ab", "http://www.lucernepublishing.com")
nodeList = root.SelectNodes("//ab:book[contains(ab:title,""'Emma'"")]", nsmgr)

Cette méthode est une extension Microsoft du DOM (Document Object Model).

L’objet XmlNodeList retourné par cette méthode sera valide tant que le document sous-jacent reste inchangé. Si le document sous-jacent change, des résultats inattendus peuvent être retournés (aucune exception ne sera levée).

Voir aussi

• Sélections XPath et fonctions personnalisées, etc.
• Recommandation W3C XPath 1.0