XPath.EvaluateToItem Method (IXPathNavigable)XPath.EvaluateToItem Method (IXPathNavigable)XPath::EvaluateToItem Method (IXPathNavigable^)

Returns an XPathItem XPathItem XPathItem representing the result of evaluating the XPath expression, or null a null reference (Nothing in Visual Basic) nullptr if the expression returns the empty sequence.

Namespace: XmlPrime XmlPrime XmlPrime
Assembly: XmlPrime (in XmlPrime.dll)

Syntax

Public Function EvaluateToItem( _
    contextItem As System.Xml.XPath.IXPathNavigable _
) As System.Xml.XPath.XPathItem

public System.Xml.XPath.XPathItem EvaluateToItem(
    System.Xml.XPath.IXPathNavigable contextItem
)

public:
System.Xml.XPath::XPathItem^ EvaluateToItem(
    System.Xml.XPath::IXPathNavigable^ contextItem
)

Parameters

contextItem

Type: System.Xml.XPath.IXPathNavigableSystem.Xml.XPath.IXPathNavigableSystem.Xml.XPath::IXPathNavigable^

The context item for the expression.

Return Value

Type: System.Xml.XPath.XPathItemSystem.Xml.XPath.XPathItemSystem.Xml.XPath::XPathItem^

An XPathItem XPathItem XPathItem, or null a null reference (Nothing in Visual Basic) nullptr if the expression returns the empty sequence.

Exceptions

Exception	Condition
ArgumentNullException ArgumentNullException ArgumentNullException	contextItem is `null` a null reference (`Nothing` in Visual Basic) `nullptr`.
XdmException XdmException XdmException	An error occurred evaluating the expression. An `XPST0004` error is raised if the expression did not return exactly one item.
LicenceException LicenceException LicenceException	This version of XmlPrime has expired.

Remarks

The item in returned will either be an XPathNavigator XPathNavigator XPathNavigator instance (if the expression returns a node) or XPathAtomicValue XPathAtomicValue XPathAtomicValue instances (if the expression returns an atomic value). values).