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

Returns an XPathItem XPathItem XPathItem representing the result of evaluating the XQuery program, or null a null reference (Nothing in Visual Basic) nullptr if the query 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 query 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 query. An `XPST0004` error is raised if the query did not return exactly one item.

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).