XPathNavigator::SelectSingleNode Method (XPathExpression^)
Selects a single node in the XPathNavigator using the specified XPathExpression object.
Assembly: System.Xml (in System.Xml.dll)
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.
| 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. |
The SelectSingleNode method selects the first node that matches the compiled XPath query contained in the XPathExpression object in the XPathNavigator.
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);
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>
Available since 2.0
Silverlight
Available since 4.0