This topic has not yet been rated - Rate this topic

XPathNavigator.SelectSingleNode Method (XPathExpression)

.NET Framework 4.5

Selects a single node in the XPathNavigator using the specified XPathExpression object.

Namespace: System.Xml.XPath
Assembly: System.Xml (in System.Xml.dll)

public virtual XPathNavigator SelectSingleNode(
	XPathExpression expression
)

Parameters

expression: Type: System.Xml.XPath.XPathExpression
An XPathExpression object containing the compiled XPath query.

Return Value

Type: System.Xml.XPath.XPathNavigator
An XPathNavigator object that contains the first matching node for the XPath query specified; otherwise null if there are no query results.

Exceptions

Exception	Condition
ArgumentException	An error was encountered in the XPath query or the return type of the XPath expression is not a node.
XPathException	The XPath query is not valid.

Remarks

The SelectSingleNode method selects the first node that matches the compiled XPath query contained in the XPathExpression object in the XPathNavigator.

Examples

The following example selects a single node from the XPathNavigator based on the XPath query contained in the XPathExpression.

C++

XPathDocument document = new XPathDocument("books.xml");
XPathNavigator navigator = document.CreateNavigator();

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

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

The example takes the books.xml file as an input.

None

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

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

XPathNavigator Class

SelectSingleNode Overload

System.Xml.XPath Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)