IXPathExpression.Evaluate

IXPathExpression.Evaluate method

计算此 XPath 表达式并返回结果。

public IXPathResult Evaluate(Node contextNode, XPathResultType type, object result)
范围类型描述
contextNodeNode语境是用于计算此 XPath 表达式的上下文节点。 如果IXPathEvaluator是通过铸造获得的Document那么这必须是同一文档所拥有的 并且必须是Document,Element,Attr , Text,CDATASection,Comment,ProcessingInstruction , 或XPathNamespace节点。如果上下文节点是TextCDATASection 然后上下文被解释为 XPath 所见的整个逻辑文本节点,除非节点为空 在这种情况下它可能不作为 XPath 上下文。
typeXPathResultType如果一个特定的类型被指定,则结果将被强制返回依赖于 XPath 转换的 指定类型,如果无法进行所需的强制转换,则结果将失败。这必须是 的值之一XPathResultType.
resultObject结果指定一个特定的结果对象,该对象可以被此方法重用并返回 。如果指定为无效的或者实现不重用指定的 结果,将构造并返回一个新的结果对象。对于 XPath 1.0 结果,此对象将是 类型IXPathResult.

返回值

XPath 表达式的计算结果。对于 XPath 1.0 结果,此对象将是 类型IXPathResult.

例外

例外(健康)状况
DOMExceptionTYPE_ERR:如果无法将结果转换为返回指定类型,则引发。
DOMExceptionWRONG_DOCUMENT_ERR:节点来自 不支持的文档IXPathEvaluator创造了这个IXPathExpression.
DOMExceptionNOT_SUPPORTED_ERR:该节点不是允许作为 XPath 上下文节点 的类型,或者该节点不允许请求类型IXPathExpression.

也可以看看