XmlNode.SelectNodes Méthode

Définition

Espace de noms:
System.Xml
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

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

Surcharges

Nom Description
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 fichier fourni XmlNamespaceManager.

Remarques

Les expressions XPath peuvent inclure des espaces de noms. La résolution d’espace de noms est prise en charge à l’aide du XmlNamespaceManagerfichier . Si l’expression XPath inclut un préfixe, la paire d’URI de préfixe et d’espace de noms doit être ajoutée au XmlNamespaceManagerfichier .

Note

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 à l’objet XmlNamespaceManager; 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. Pour obtenir des exemples de code, choisissez une surcharge dans la liste de surcharges de la section précédente.

SelectNodes(String)

Source:
XmlNode.cs
Source:
XmlNode.cs
Source:
XmlNode.cs
Source:
XmlNode.cs
Source:
XmlNode.cs

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

public:
 System::Xml::XmlNodeList ^ SelectNodes(System::String ^ xpath);
public System.Xml.XmlNodeList? SelectNodes(string xpath);
public System.Xml.XmlNodeList SelectNodes(string xpath);
member this.SelectNodes : string -> System.Xml.XmlNodeList
Public Function SelectNodes (xpath As String) As XmlNodeList

Paramètres

xpath
String

Expression XPath.

Retours

XmlNodeList

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

Exceptions

XPathException

L’expression XPath contient un préfixe.

Exemples

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

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);
    }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    'Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    doc.Load("booksort.xml")
           
    Dim book as XmlNode
    Dim nodeList as XmlNodeList 
    Dim root as XmlNode = doc.DocumentElement

    nodeList=root.SelectNodes("descendant::book[author/last-name='Austen']")
 
    'Change the price on the books.
    for each book in nodeList      
      book.LastChild.InnerText="15.95"
    next 

    Console.WriteLine("Display the modified XML document....")
    doc.Save(Console.Out)
    
  end sub
end class

Cet exemple utilise le code XML suivant :


<?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 argument comme argument. Utilisé XmlNamespaceManager pour résoudre les espaces de noms.

Note

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 le XmlNamespaceManager préfixe et l’URI d’espace de noms à celui-ci ; 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.

Note

Un problème courant lors de la formulation d’expressions XPath consiste à inclure un guillemet unique (') 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.

Prenons l’exemple du code XML suivant :

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

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

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

Cette méthode est une extension Microsoft au dom (Document Object Model).

L’objet XmlNodeList retourné par cette méthode sera valide alors 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’applique à

SelectNodes(String, XmlNamespaceManager)

Source:
XmlNode.cs
Source:
XmlNode.cs
Source:
XmlNode.cs
Source:
XmlNode.cs
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 fichier fourni XmlNamespaceManager.

public:
 System::Xml::XmlNodeList ^ SelectNodes(System::String ^ xpath, System::Xml::XmlNamespaceManager ^ nsmgr);
public System.Xml.XmlNodeList? SelectNodes(string xpath, System.Xml.XmlNamespaceManager nsmgr);
public System.Xml.XmlNodeList SelectNodes(string xpath, System.Xml.XmlNamespaceManager nsmgr);
member this.SelectNodes : string * System.Xml.XmlNamespaceManager -> System.Xml.XmlNodeList
Public Function SelectNodes (xpath As String, nsmgr As XmlNamespaceManager) As XmlNodeList

Paramètres

xpath
String

Expression XPath.

nsmgr
XmlNamespaceManager

À XmlNamespaceManager utiliser pour résoudre les espaces de noms pour les préfixes dans l’expression XPath.

Retours

XmlNodeList

Contenant XmlNodeList 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 le 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.

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);
      }
   }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

      Dim doc as XmlDocument = new XmlDocument()
      doc.Load("booksort.xml")

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

      'Select and display the value of all the ISBN attributes.
      Dim nodeList as XmlNodeList 
      Dim root as XmlElement = doc.DocumentElement
      nodeList = root.SelectNodes("/bookstore/book/@bk:ISBN", nsmgr)
      Dim isbn as XmlNode
      for each isbn in nodeList
        Console.WriteLine(isbn.Value)
      next

  end sub
end class

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


<?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 est prise en charge à l’aide du XmlNamespaceManagerfichier . Si l’expression XPath inclut un préfixe, la paire d’URI de préfixe et d’espace de noms doit être ajoutée au XmlNamespaceManagerfichier .

Note

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 à l’objet XmlNamespaceManager; 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.

Par exemple, si vous avez le code XML suivant :

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

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

Note

Un problème courant lors de la formulation d’expressions XPath consiste à inclure un guillemet unique (') 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.

Prenons l’exemple du code XML suivant :

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

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 au dom (Document Object Model).

L’objet XmlNodeList retourné par cette méthode sera valide alors 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’applique à