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

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( _
    settings As DynamicContextSettings _
) As System.Xml.XPath.XPathItem

public System.Xml.XPath.XPathItem EvaluateToItem(
    DynamicContextSettings settings
)

public:
System.Xml.XPath::XPathItem^ EvaluateToItem(
    DynamicContextSettings^ settings
)

Parameters

settings

Type: XmlPrime.DynamicContextSettingsXmlPrime.DynamicContextSettingsXmlPrime::DynamicContextSettings^

The settings of the dynamic evaluation context.

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	settings 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.
InvalidOperationException InvalidOperationException InvalidOperationException	An error is raised if the expression returns more than one item.

Remarks

The item returned will either be an instance of XPathNavigator XPathNavigator XPathNavigator (if the expression returns a node), XPathAtomicValue XPathAtomicValue XPathAtomicValue (if the expression returns an atomic value) or XPathFunctionItem XPathFunctionItem XPathFunctionItem (if the expression returns a function item).