XPathNavigator.SelectSingleNode XPathNavigator.SelectSingleNode XPathNavigator.SelectSingleNode XPathNavigator.SelectSingleNode Method

定義

XPathNavigator 内の単一のノードを選択します。Selects a single node in the XPathNavigator.

オーバーロード

SelectSingleNode(String, IXmlNamespaceResolver) SelectSingleNode(String, IXmlNamespaceResolver) SelectSingleNode(String, IXmlNamespaceResolver) SelectSingleNode(String, IXmlNamespaceResolver)

名前空間プレフィックスを解決するために指定された XPathNavigator オブジェクトと共に、指定された XPath クエリを使用して IXmlNamespaceResolver オブジェクト内の単一のノードを選択します。Selects a single node in the XPathNavigator object using the specified XPath query with the IXmlNamespaceResolver object specified to resolve namespace prefixes.

SelectSingleNode(String) SelectSingleNode(String) SelectSingleNode(String) SelectSingleNode(String)

指定された XPath クエリを使用して、XPathNavigator 内の単一のノードを選択します。Selects a single node in the XPathNavigator using the specified XPath query.

SelectSingleNode(XPathExpression) SelectSingleNode(XPathExpression) SelectSingleNode(XPathExpression) SelectSingleNode(XPathExpression)

指定された XPathNavigator オブジェクトを使用して、XPathExpression 内の単一のノードを選択します。Selects a single node in the XPathNavigator using the specified XPathExpression object.

SelectSingleNode(String, IXmlNamespaceResolver) SelectSingleNode(String, IXmlNamespaceResolver) SelectSingleNode(String, IXmlNamespaceResolver) SelectSingleNode(String, IXmlNamespaceResolver)

名前空間プレフィックスを解決するために指定された XPathNavigator オブジェクトと共に、指定された XPath クエリを使用して IXmlNamespaceResolver オブジェクト内の単一のノードを選択します。Selects a single node in the XPathNavigator object using the specified XPath query with the IXmlNamespaceResolver object specified to resolve namespace prefixes.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::String ^ xpath, System::Xml::IXmlNamespaceResolver ^ resolver);
public virtual System.Xml.XPath.XPathNavigator SelectSingleNode (string xpath, System.Xml.IXmlNamespaceResolver resolver);
abstract member SelectSingleNode : string * System.Xml.IXmlNamespaceResolver -> System.Xml.XPath.XPathNavigator
override this.SelectSingleNode : string * System.Xml.IXmlNamespaceResolver -> System.Xml.XPath.XPathNavigator
Public Overridable Function SelectSingleNode (xpath As String, resolver As IXmlNamespaceResolver) As XPathNavigator

パラメーター

xpath
String String String String

XPath 式を表す StringA String representing an XPath expression.

resolver
IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver IXmlNamespaceResolver

XPath クエリの名前空間プレフィックスの解決に使用する IXmlNamespaceResolver オブジェクト。The IXmlNamespaceResolver object used to resolve namespace prefixes in the XPath query.

戻り値

指定された XPath クエリに対して最初に一致するノードが格納された XPathNavigator オブジェクト。クエリ結果がない場合は nullAn XPathNavigator object that contains the first matching node for the XPath query specified; otherwise null if there are no query results.

例外

XPath クエリでエラーが発生したか、または XPath 式の戻り値の型がノードではありません。An error was encountered in the XPath query or the return type of the XPath expression is not a node.

XPath クエリが無効です。The XPath query is not valid.

次の例では、指定されXPathNavigatorた xpath クエリに基づいてオブジェクトから1つXmlNamespaceManagerのノードを選択し、指定されたオブジェクトを使用して xpath クエリ内の名前空間プレフィックスを解決します。The following example selects a single node from the XPathNavigator object based on the XPath query specified and uses the XmlNamespaceManager object specified to resolve namespace prefixes in the XPath query.

XPathDocument^ document = gcnew XPathDocument("contosoBooks.xml");
XPathNavigator^ navigator = document->CreateNavigator();

XmlNamespaceManager^ manager = gcnew XmlNamespaceManager(navigator->NameTable);
manager->AddNamespace("bk", "http://www.contoso.com/books");

XPathNavigator^ node = navigator->SelectSingleNode("//bk:title", manager);
Console::WriteLine(node->InnerXml);
XPathDocument document = new XPathDocument("contosoBooks.xml");
XPathNavigator navigator = document.CreateNavigator();

XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);
manager.AddNamespace("bk", "http://www.contoso.com/books");

XPathNavigator node = navigator.SelectSingleNode("//bk:title", manager);
Console.WriteLine(node.InnerXml);
Dim document As XPathDocument = New XPathDocument("contosoBooks.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

Dim manager As XmlNamespaceManager = New XmlNamespaceManager(navigator.NameTable)
manager.AddNamespace("bk", "http://www.contoso.com/books")

Dim node As XPathNavigator = navigator.SelectSingleNode("//bk:title", manager)
Console.WriteLine(node.InnerXml)

この例は、contosoBooks.xml ファイルを入力として使用します。The example takes the contosoBooks.xml file as an input.

  
<?xml version="1.0" encoding="utf-8" ?>  
<bookstore xmlns="http://www.contoso.com/books">  
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">  
        <title>The Autobiography of Benjamin Franklin</title>  
        <author>  
            <first-name>Benjamin</first-name>  
            <last-name>Franklin</last-name>  
        </author>  
        <price>8.99</price>  
    </book>  
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">  
        <title>The Confidence Man</title>  
        <author>  
            <first-name>Herman</first-name>  
            <last-name>Melville</last-name>  
        </author>  
        <price>11.99</price>  
    </book>  
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">  
        <title>The Gorgias</title>  
        <author>  
            <name>Plato</name>  
        </author>  
        <price>9.99</price>  
    </book>  
</bookstore>  
  

注釈

メソッドSelectSingleNodeは、指定された XPath クエリに一致する最初のノードを選択します。The SelectSingleNode method selects the first node that matches the XPath query specified. メソッドSelectSingleNodeは、 IXmlNamespaceResolverオブジェクトを使用して名前空間プレフィックスを解決します。The SelectSingleNode method uses the IXmlNamespaceResolver object to resolve namespace prefixes.

注意

XPath では、すべての名前空間にクエリの先頭にプレフィックスを付ける必要があります。In XPath all namespaces must be prefixed in a query. XML ドキュメントで既定の名前空間を使用する場合でも、 IXmlNamespaceResolverオブジェクトに名前空間プレフィックスを追加する必要があります。If an XML document uses a default namespace, you must still add a namespace prefix to the IXmlNamespaceResolver object.

SelectSingleNode(String) SelectSingleNode(String) SelectSingleNode(String) SelectSingleNode(String)

指定された XPath クエリを使用して、XPathNavigator 内の単一のノードを選択します。Selects a single node in the XPathNavigator using the specified XPath query.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::String ^ xpath);
public virtual System.Xml.XPath.XPathNavigator SelectSingleNode (string xpath);
abstract member SelectSingleNode : string -> System.Xml.XPath.XPathNavigator
override this.SelectSingleNode : string -> System.Xml.XPath.XPathNavigator
Public Overridable Function SelectSingleNode (xpath As String) As XPathNavigator

パラメーター

xpath
String String String String

XPath 式を表す StringA String representing an XPath expression.

戻り値

指定された XPath クエリに対して最初に一致するノードが格納された XPathNavigator オブジェクト。クエリ結果がない場合は nullAn XPathNavigator object that contains the first matching node for the XPath query specified; otherwise, null if there are no query results.

例外

XPath クエリでエラーが発生したか、または XPath 式の戻り値の型がノードではありません。An error was encountered in the XPath query or the return type of the XPath expression is not a node.

XPath クエリが無効です。The XPath query is not valid.

次の例では、指定されXPathNavigatorた XPath クエリに基づいて、から1つのノードを選択します。The following example selects a single node from the XPathNavigator based on the XPath query specified.

XPathDocument^ document = gcnew XPathDocument("books.xml");
XPathNavigator^ navigator = document->CreateNavigator();

XPathNavigator^ node = navigator->SelectSingleNode("//title");
Console::WriteLine(node->InnerXml);
XPathDocument document = new XPathDocument("books.xml");
XPathNavigator navigator = document.CreateNavigator();

XPathNavigator node = navigator.SelectSingleNode("//title");
Console.WriteLine(node.InnerXml);
Dim document As XPathDocument = New XPathDocument("books.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

Dim node As XPathNavigator = navigator.SelectSingleNode("//title")
Console.WriteLine(node.InnerXml)

この例は、books.xml ファイルを入力として使用します。The example takes the books.xml file as an input.

  
<?xml version="1.0" encoding="utf-8" ?>   
<bookstore>  
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">  
        <title>The Autobiography of Benjamin Franklin</title>  
        <author>  
            <first-name>Benjamin</first-name>  
            <last-name>Franklin</last-name>  
        </author>  
        <price>8.99</price>  
    </book>  
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">  
        <title>The Confidence Man</title>  
        <author>  
            <first-name>Herman</first-name>  
            <last-name>Melville</last-name>  
        </author>  
        <price>11.99</price>  
    </book>  
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">  
        <title>The Gorgias</title>  
        <author>  
            <name>Plato</name>  
        </author>  
        <price>9.99</price>  
    </book>  
</bookstore>  
  

注釈

メソッドSelectSingleNodeは、 XPathNavigatorオブジェクト内の XPath クエリに一致する最初のノードを選択します。The SelectSingleNode method selects the first node that matches the XPath query in the XPathNavigator object.

SelectSingleNode(XPathExpression) SelectSingleNode(XPathExpression) SelectSingleNode(XPathExpression) SelectSingleNode(XPathExpression)

指定された XPathNavigator オブジェクトを使用して、XPathExpression 内の単一のノードを選択します。Selects a single node in the XPathNavigator using the specified XPathExpression object.

public:
 virtual System::Xml::XPath::XPathNavigator ^ SelectSingleNode(System::Xml::XPath::XPathExpression ^ expression);
public virtual System.Xml.XPath.XPathNavigator SelectSingleNode (System.Xml.XPath.XPathExpression expression);
abstract member SelectSingleNode : System.Xml.XPath.XPathExpression -> System.Xml.XPath.XPathNavigator
override this.SelectSingleNode : System.Xml.XPath.XPathExpression -> System.Xml.XPath.XPathNavigator
Public Overridable Function SelectSingleNode (expression As XPathExpression) As XPathNavigator

パラメーター

expression
XPathExpression XPathExpression XPathExpression XPathExpression

コンパイル済みの XPath クエリが格納されている XPathExpression オブジェクト。An XPathExpression object containing the compiled XPath query.

戻り値

指定された XPath クエリに対して最初に一致するノードが格納された XPathNavigator オブジェクト。クエリ結果がない場合は nullAn XPathNavigator object that contains the first matching node for the XPath query specified; otherwise null if there are no query results.

例外

XPath クエリでエラーが発生したか、または XPath 式の戻り値の型がノードではありません。An error was encountered in the XPath query or the return type of the XPath expression is not a node.

XPath クエリが無効です。The XPath query is not valid.

次の例では、に含まれXPathNavigatorているXPathExpressionXPath クエリに基づいて、から1つのノードを選択します。The following example selects a single node from the XPathNavigator based on the XPath query contained in the XPathExpression.

XPathDocument^ document = gcnew XPathDocument("books.xml");
XPathNavigator^ navigator = document->CreateNavigator();

XPathExpression^ query = navigator->Compile("//title");

XPathNavigator^ node = navigator->SelectSingleNode(query);
Console::WriteLine(node->InnerXml);
XPathDocument document = new XPathDocument("books.xml");
XPathNavigator navigator = document.CreateNavigator();

XPathExpression query = navigator.Compile("//title");

XPathNavigator node = navigator.SelectSingleNode(query);
Console.WriteLine(node.InnerXml);
Dim document As XPathDocument = New XPathDocument("books.xml")
Dim navigator As XPathNavigator = document.CreateNavigator()

Dim query As XPathExpression = navigator.Compile("//title")

Dim node As XPathNavigator = navigator.SelectSingleNode(query)
Console.WriteLine(node.InnerXml)

この例は、books.xml ファイルを入力として使用します。The example takes the books.xml file as an input.

  
<?xml version="1.0" encoding="utf-8" ?>   
<bookstore>  
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">  
        <title>The Autobiography of Benjamin Franklin</title>  
        <author>  
            <first-name>Benjamin</first-name>  
            <last-name>Franklin</last-name>  
        </author>  
        <price>8.99</price>  
    </book>  
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">  
        <title>The Confidence Man</title>  
        <author>  
            <first-name>Herman</first-name>  
            <last-name>Melville</last-name>  
        </author>  
        <price>11.99</price>  
    </book>  
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">  
        <title>The Gorgias</title>  
        <author>  
            <name>Plato</name>  
        </author>  
        <price>9.99</price>  
    </book>  
</bookstore>  
  

注釈

メソッドSelectSingleNodeXPathExpressionXPathNavigator内のオブジェクトに格納されているコンパイル済みの XPath クエリと一致する最初のノードを選択します。The SelectSingleNode method selects the first node that matches the compiled XPath query contained in the XPathExpression object in the XPathNavigator.

適用対象