XmlNode.SelectNodes Metode

Definisi

Ruang nama:
System.Xml
Rakitan:
netstandard.dll, System.Xml.ReaderWriter.dll
Rakitan:
System.Xml.ReaderWriter.dll
Rakitan:
System.Xml.dll
Rakitan:
netstandard.dll

Memilih daftar simpul yang cocok dengan ekspresi XPath.

Overload

Nama Deskripsi
SelectNodes(String)

Memilih daftar simpul yang cocok dengan ekspresi XPath.
SelectNodes(String, XmlNamespaceManager)

Memilih daftar simpul yang cocok dengan ekspresi XPath. Setiap awalan yang ditemukan dalam ekspresi XPath diselesaikan menggunakan yang disediakan XmlNamespaceManager.

Keterangan

Ekspresi XPath dapat menyertakan namespace layanan. Resolusi namespace didukung menggunakan XmlNamespaceManager. Jika ekspresi XPath menyertakan awalan, pasangan URI awalan dan namespace harus ditambahkan ke XmlNamespaceManager.

Nota

Jika ekspresi XPath tidak menyertakan awalan, diasumsikan bahwa URI namespace adalah namespace kosong. Jika XML Anda menyertakan namespace default, Anda masih harus menambahkan awalan dan namespace URI ke XmlNamespaceManager; jika tidak, Anda tidak akan mendapatkan simpul apa pun yang dipilih.

Untuk informasi selengkapnya, lihat Memilih Simpul Menggunakan Navigasi XPath. Untuk contoh kode, pilih kelebihan beban dari daftar kelebihan beban di bagian sebelumnya.

SelectNodes(String)

Sumber:
XmlNode.cs
Sumber:
XmlNode.cs
Sumber:
XmlNode.cs
Sumber:
XmlNode.cs
Sumber:
XmlNode.cs

Memilih daftar simpul yang cocok dengan ekspresi 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

Parameter

xpath
String

Ekspresi XPath.

Mengembalikan

XmlNodeList

Berisi XmlNodeList kumpulan simpul yang cocok dengan kueri XPath.

Pengecualian

XPathException

Ekspresi XPath berisi awalan.

Contoh

Contoh berikut memilih semua buku di mana nama belakang penulis adalah Austen, lalu mengubah harga buku-buku tersebut.

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

Contoh ini menggunakan XML berikut:


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

Keterangan

Jika ekspresi XPath memerlukan resolusi namespace, Anda harus menggunakan SelectNodes kelebihan beban yang mengambil XmlNamespaceManager sebagai argumennya. XmlNamespaceManager digunakan untuk mengatasi namespace layanan.

Nota

Jika ekspresi XPath tidak menyertakan awalan, diasumsikan bahwa URI namespace adalah namespace kosong. Jika XML Anda menyertakan namespace default, Anda masih harus menggunakan XmlNamespaceManager dan menambahkan awalan dan namespace URI ke dalamnya; jika tidak, Anda tidak akan mendapatkan simpul apa pun yang dipilih. Untuk informasi selengkapnya, lihat Memilih Simpul Menggunakan Navigasi XPath.

Nota

Masalah umum saat merumuskan ekspresi XPath adalah cara menyertakan tanda kutip tunggal (') atau tanda kutip ganda (") dalam ekspresi. Jika Anda harus mencari nilai yang menyertakan kuotasi tunggal, Anda harus mengapit string dalam tanda kutip ganda. Jika Anda perlu mencari nilai yang menyertakan tanda kutip ganda, Anda harus mengapit string dalam tanda kutip tunggal.

Misalnya, Anda memiliki XML berikut:

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

Kode Visual Basic berikut memilih elemen yang berisi tanda kutip tunggal:

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

Metode ini adalah ekstensi Microsoft ke Model Objek Dokumen (DOM).

Objek XmlNodeList yang dikembalikan oleh metode ini akan valid sementara dokumen yang mendasar tetap tidak berubah. Jika dokumen yang mendasar berubah, hasil yang tidak terduga dapat dikembalikan (tidak ada pengecualian yang akan dilemparkan).

Lihat juga

Berlaku untuk

SelectNodes(String, XmlNamespaceManager)

Sumber:
XmlNode.cs
Sumber:
XmlNode.cs
Sumber:
XmlNode.cs
Sumber:
XmlNode.cs
Sumber:
XmlNode.cs

Memilih daftar simpul yang cocok dengan ekspresi XPath. Setiap awalan yang ditemukan dalam ekspresi XPath diselesaikan menggunakan yang disediakan 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

Parameter

xpath
String

Ekspresi XPath.

nsmgr
XmlNamespaceManager

Yang XmlNamespaceManager digunakan untuk mengatasi namespace layanan untuk awalan dalam ekspresi XPath.

Mengembalikan

XmlNodeList

Berisi XmlNodeList kumpulan simpul yang cocok dengan kueri XPath.

Pengecualian

XPathException

Ekspresi XPath berisi awalan yang tidak ditentukan dalam XmlNamespaceManager.

Contoh

Contoh berikut menampilkan nilai masing-masing atribut ISBN. Contoh ini menggunakan XmlElement objek, yang mewarisi dari XmlNode kelas .

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

Contohnya menggunakan file, booksort.xml, sebagai input.


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

Keterangan

Ekspresi XPath dapat menyertakan namespace layanan. Resolusi namespace didukung menggunakan XmlNamespaceManager. Jika ekspresi XPath menyertakan awalan, pasangan URI awalan dan namespace harus ditambahkan ke XmlNamespaceManager.

Nota

Jika ekspresi XPath tidak menyertakan awalan, diasumsikan bahwa URI namespace adalah namespace kosong. Jika XML Anda menyertakan namespace default, Anda masih harus menambahkan awalan dan namespace URI ke XmlNamespaceManager; jika tidak, Anda tidak akan mendapatkan simpul apa pun yang dipilih. Untuk informasi selengkapnya, lihat Memilih Simpul Menggunakan Navigasi XPath.

Misalnya, jika Anda memiliki XML berikut:

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

Kode C# berikut memilih semua simpul buku:

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

Nota

Masalah umum saat merumuskan ekspresi XPath adalah cara menyertakan tanda kutip tunggal (') atau tanda kutip ganda (") dalam ekspresi. Jika Anda harus mencari nilai yang menyertakan kuotasi tunggal, Anda harus mengapit string dalam tanda kutip ganda. Jika Anda perlu mencari nilai yang menyertakan tanda kutip ganda, Anda harus mengapit string dalam tanda kutip tunggal.

Misalnya, Anda memiliki XML berikut:

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

Kode Visual Basic berikut memilih elemen yang berisi tanda kutip tunggal:

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)

Metode ini adalah ekstensi Microsoft ke Model Objek Dokumen (DOM).

Objek XmlNodeList yang dikembalikan oleh metode ini akan valid sementara dokumen yang mendasar tetap tidak berubah. Jika dokumen yang mendasar berubah, hasil yang tidak terduga dapat dikembalikan (tidak ada pengecualian yang akan dilemparkan).

Lihat juga

Berlaku untuk