Note: This method is new in the .NET Framework version 2.0.
Selects a single node in the
XPathNavigator using the specified
XPathExpression object.
Namespace: System.Xml.XPath
Assembly: System.Xml (in system.xml.dll)
Visual Basic (Declaration)
Public Overridable Function SelectSingleNode ( _
expression As XPathExpression _
) As XPathNavigator
Dim instance As XPathNavigator
Dim expression As XPathExpression
Dim returnValue As XPathNavigator
returnValue = instance.SelectSingleNode(expression)
public virtual XPathNavigator SelectSingleNode (
XPathExpression expression
)
public:
virtual XPathNavigator^ SelectSingleNode (
XPathExpression^ expression
)
public XPathNavigator SelectSingleNode (
XPathExpression expression
)
public function SelectSingleNode (
expression : XPathExpression
) : XPathNavigator
Parameters
- expression
An XPathExpression object containing the compiled XPath query.
Return Value
An XPathNavigator object that contains the first matching node for the XPath query specified; otherwise a null reference (Nothing in Visual Basic) if there are no query results.
| Exception type | 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.
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)
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.
<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>
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
.NET Framework
Supported in: 2.0