XmlNode.SelectSingleNode メソッド

定義

名前空間:: System.Xml

アセンブリ:: netstandard.dll, System.Xml.ReaderWriter.dll

アセンブリ:: System.Xml.ReaderWriter.dll

アセンブリ:: System.Xml.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

XPath 式に一致する最初の XmlNode を選択します。

オーバーロード

名前	説明
SelectSingleNode(String)	XPath 式に一致する最初の `XmlNode` を選択します。
SelectSingleNode(String, XmlNamespaceManager)	XPath 式に一致する最初の `XmlNode` を選択します。 XPath 式で見つかったプレフィックスはすべて、指定された XmlNamespaceManagerを使用して解決されます。

例

次の使用例は、著者名が一致する最初の書籍を返します。 XmlNamespaceManagerは、XPath 式の既定の名前空間を解決します。

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

Imports System.IO
Imports System.Xml

Public Class Sample

  Public Shared Sub Main()

      Dim doc As XmlDocument = New XmlDocument()
      doc.Load("newbooks.xml")

      'Create an XmlNamespaceManager for resolving namespaces.
      Dim nsmgr As XmlNamespaceManager = New XmlNamespaceManager(doc.NameTable)
      nsmgr.AddNamespace("bk", "urn:newbooks-schema")

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

      Console.WriteLine(book.OuterXml)

  End Sub
End Class

この例では、 newbooks.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に追加する必要があります。

Note

XPath 式にプレフィックスが含まれていない場合は、名前空間 URI が空の名前空間であると見なされます。 XML に既定の名前空間が含まれている場合でも、プレフィックスと名前空間 URI を XmlNamespaceManagerに追加する必要があります。それ以外の場合は、ノードは選択されません。詳細については、「 XPath ナビゲーションを使用したノードの選択」を参照してください。

SelectSingleNode(String)

ソース:: XmlNode.cs

ソース:: XmlNode.cs

ソース:: XmlNode.cs

ソース:: XmlNode.cs

ソース:: XmlNode.cs

XPath 式に一致する最初の XmlNode を選択します。

public:
 System::Xml::XmlNode ^ SelectSingleNode(System::String ^ xpath);

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

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

member this.SelectSingleNode : string -> System.Xml.XmlNode

Public Function SelectSingleNode (xpath As String) As XmlNode

パラメーター

xpath: String

XPath 式。 XPath の例を参照してください。

返品

XmlNode

XPath クエリに一致する最初の XmlNode 。一致するノードが見つからない場合は null 。

例外

XPathException

XPath 式にはプレフィックスが含まれています。

例

次の例では、最初の Jane Austen ブックの価格を変更します。

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

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 root as XmlNode = 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)
    
  end sub
end class

この例では、 booksort.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は名前空間の解決に使用されます。

Note

XPath 式にプレフィックスが含まれていない場合は、名前空間 URI が空の名前空間であると見なされます。 XML に既定の名前空間が含まれている場合でも、 XmlNamespaceManager を使用し、プレフィックスと名前空間 URI を追加する必要があります。それ以外の場合は、選択したノードは取得されません。詳細については、「 XPath ナビゲーションを使用したノードの選択」を参照してください。

Note

XPath 式を作成するときの一般的な問題は、式に単一引用符 (') または二重引用符 (") を含める方法です。単一引用符を含む値を検索する必要がある場合は、文字列を二重引用符で囲む必要があります。二重引用符を含む値を検索する必要がある場合は、文字列を一重引用符で囲む必要があります。

たとえば、次のような XML コードがあるとします:

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

次のVisual Basicコードは、単一引用符を含む要素を選択します。

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

このメソッドは、ドキュメントオブジェクトモデル (DOM) のMicrosoft拡張機能です。

こちらもご覧ください

適用対象

SelectSingleNode(String, XmlNamespaceManager)

ソース:: XmlNode.cs

ソース:: XmlNode.cs

ソース:: XmlNode.cs

ソース:: XmlNode.cs

ソース:: XmlNode.cs

XPath 式に一致する最初の XmlNode を選択します。 XPath 式で見つかったプレフィックスはすべて、指定された XmlNamespaceManagerを使用して解決されます。

public:
 System::Xml::XmlNode ^ SelectSingleNode(System::String ^ xpath, System::Xml::XmlNamespaceManager ^ nsmgr);

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

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

member this.SelectSingleNode : string * System.Xml.XmlNamespaceManager -> System.Xml.XmlNode

Public Function SelectSingleNode (xpath As String, nsmgr As XmlNamespaceManager) As XmlNode

パラメーター

xpath: String

XPath 式。 XPath の例を参照してください。

nsmgr: XmlNamespaceManager

XPath 式のプレフィックスの名前空間を解決するために使用する XmlNamespaceManager 。

返品

XmlNode

XPath クエリに一致する最初の XmlNode 。一致するノードが見つからない場合は null 。

例外

XPathException

XPath 式には、 XmlNamespaceManagerで定義されていないプレフィックスが含まれています。

例

次の例では、ISBN 値が一致する書籍を選択します。

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

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

      Console.WriteLine(book.OuterXml)

  end sub
end class

この例では、 booksort.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>

注釈

Note

XPath 式にプレフィックスが含まれていない場合は、名前空間 URI が空の名前空間であると見なされます。 XML に既定の名前空間が含まれている場合でも、プレフィックスと名前空間 URI を XmlNamespaceManagerに追加する必要があります。それ以外の場合、ノードは選択されません。詳細については、「 XPath ナビゲーションを使用したノードの選択」を参照してください。

たとえば、次の XML があるとします。

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

次の C# コードは、最初のブックノードを選択します。

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

Note

たとえば、次のような XML コードがあるとします:

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

次のVisual Basicコードは、単一引用符を含む要素を選択します。

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拡張機能です。

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?