XmlNode.SelectSingleNode 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

選取符合 XPath 運算式的第一個 XmlNode。

多載

SelectSingleNode(String)	選取符合 XPath 運算式的第一個 XmlNode。
SelectSingleNode(String, XmlNamespaceManager)	選取符合 XPath 運算式的第一個 XmlNode。 使用提供的 XmlNamespaceManager 解析 XPath 運算式中找到的任何前置詞。

範例

下列範例會傳回具有相符作者名稱的第一本書籍。 XmlNamespaceManager 會解析 XPath 運算式中的預設命名空間。

C#

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

public class Sample
{
  public static void Main()
  {

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

      // Create an XmlNamespaceManager to resolve the default namespace.
      XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);
      nsmgr.AddNamespace("bk", "urn:newbooks-schema");

      // Select the first book written by an author whose last name is Atwood.
      XmlNode book;
      XmlElement root = doc.DocumentElement;
     book = root.SelectSingleNode("descendant::bk:book[bk:author/bk:last-name='Atwood']", nsmgr);

      Console.WriteLine(book.OuterXml);
  }
}

此範例會使用 檔案 newbooks.xml，作為輸入。

XML

<?xml version='1.0'?>
<bookstore xmlns="urn:newbooks-schema">
  <book genre="novel" style="hardcover">
    <title>The Handmaid's Tale</title>
    <author>
      <first-name>Margaret</first-name>
      <last-name>Atwood</last-name>
    </author>
    <price>19.95</price>
  </book>
  <book genre="novel" style="other">
    <title>The Poisonwood Bible</title>
    <author>
      <first-name>Barbara</first-name>
      <last-name>Kingsolver</last-name>
    </author>
    <price>11.99</price>
  </book>
</bookstore>

備註

XPath 運算式可包含命名空間。 命名空間解析可透過 XmlNamespaceManager 予以支援。 如果 XPath 運算式包含前置詞，則必須將前置詞和命名空間 URI 配對新增至 XmlNamespaceManager。

備註

如果 XPath 運算式不包含前置詞，則會假設命名空間 URI 是空的命名空間。 如果您的 XML 包含預設命名空間，您仍然必須將前置詞和命名空間 URI 新增至 XmlNamespaceManager，否則不會選取任何節點。 如需詳細資訊，請參閱 使用 XPath 瀏覽選取節點。

SelectSingleNode(String)

來源:

XmlNode.cs

選取符合 XPath 運算式的第一個 XmlNode。

C#

public System.Xml.XmlNode? SelectSingleNode (string xpath);

參數

xpath

String

XPath 運算式。 請參閱 XPath 範例。

傳回

XmlNode

符合 XPath 查詢的第一個 XmlNode，如果找不到符合的節點，則為 null。

例外狀況

XPathException

XPath 運算式包含前置詞。

範例

下列範例會變更第一張 Jane Austen 書籍的價格。

C#

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

public class Sample {

  public static void Main() {

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

    XmlNode book;
    XmlNode root = doc.DocumentElement;

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

    //Change the price on the book.
    book.LastChild.InnerText="15.95";

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

此範例會使用 檔案 booksort.xml，作為輸入。

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>

備註

如果 XPath 運算式需要命名空間解析，您必須使用採用 做為其自變數的多 SelectSingleNode 載 XmlNamespaceManager 。 XmlNamespaceManager用來解析命名空間。

備註

如果 XPath 運算式不包含前置詞，則會假設命名空間 URI 是空的命名空間。 如果您的 XML 包含預設命名空間，您仍然 XmlNamespaceManager 必須使用 ，並在其中新增前置詞和命名空間 URI，否則不會取得選取的節點。 如需詳細資訊，請參閱 使用 XPath 瀏覽選取節點。

備註

撰寫 XPath 運算式時的常見問題是如何在表示式中包含單引號 ( ) 或雙引號 (“) 。 如果您必須搜尋包含單引號的值，則必須以雙引號括住字元串。 如果您需要搜尋包含雙引號的值，則必須以單引號括住字元串。

例如，假設您有下列 XML：

XML

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

下列 Visual Basic 程式代碼會選取包含單引號的專案：

book = root.SelectSingleNode("descendant::book[title=""'Emma'""]")

此方法是文件物件模型 (DOM) 的 Microsoft 延伸模組。

另請參閱

• SelectNodes(String)
• XPath 選取專案和自定義函式等等
• W3C XPath 1.0 建議

SelectSingleNode(String, XmlNamespaceManager)

來源:

XmlNode.cs

選取符合 XPath 運算式的第一個 XmlNode。 使用提供的 XmlNamespaceManager 解析 XPath 運算式中找到的任何前置詞。

C#

public System.Xml.XmlNode? SelectSingleNode (string xpath, System.Xml.XmlNamespaceManager nsmgr);

參數

xpath

String

XPath 運算式。 請參閱 XPath 範例。

nsmgr

XmlNamespaceManager

XmlNamespaceManager，用來解析 XPath 運算式中前置詞的命名空間。

傳回

XmlNode

符合 XPath 查詢的第一個 XmlNode，如果找不到符合的節點，則為 null。

例外狀況

XPathException

XPath 運算式包含未定義於 XmlNamespaceManager 中的前置詞。

範例

下列範例會選取具有相符 ISBN 值的書籍。

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 the book node with the matching attribute value.
      XmlNode book;
      XmlElement root = doc.DocumentElement;
      book = root.SelectSingleNode("descendant::book[@bk:ISBN='1-861001-57-6']", nsmgr);

      Console.WriteLine(book.OuterXml);
  }
}

此範例會使用 檔案 booksort.xml，作為輸入。

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>

備註

XPath 運算式可包含命名空間。 命名空間解析可透過 XmlNamespaceManager 予以支援。 如果 XPath 運算式包含前置詞，則必須將前置詞和命名空間 URI 配對新增至 XmlNamespaceManager。

備註

如果 XPath 運算式不包含前置詞，則會假設命名空間 URI 是空的命名空間。 如果您的 XML 包含預設命名空間，您仍然必須將前置詞和命名空間 URI 新增至 XmlNamespaceManager，否則不會選取節點。 如需詳細資訊，請參閱 使用 XPath 瀏覽選取節點。

例如，如果您有下列 XML：

XML

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

下列 C# 程式代碼會選取第一個書籍節點：

C#

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

備註

撰寫 XPath 運算式時的常見問題是如何在表示式中包含單引號 ( ) 或雙引號 (“) 。 如果您必須搜尋包含單引號的值，則必須以雙引號括住字元串。 如果您需要搜尋包含雙引號的值，則必須以單引號括住字元串。

例如，假設您有下列 XML：

XML

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

下列 Visual Basic 程式代碼會選取包含單引號的專案：

VB

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

此方法是文件物件模型 (DOM) 的 Microsoft 延伸模組。

另請參閱

• XPath 選取專案和自定義函式等等
• W3C XPath 1.0 建議