IXPathEvaluator.Evaluate

IXPathEvaluator.Evaluate method

计算 XPath 表达式字符串并在可能的情况下返回指定类型的结果。

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)

范围	类型	描述
expression	String	要分析和评估的 XPath 表达式字符串。
contextNode	Node	这`语境`是用于计算此 XPath 表达式的上下文节点。如果`IXPathEvaluator`是通过铸造获得的`Document`那么这必须属于同一个文档并且必须是 `Document`,`Element`,`Attr`,`Text` , `CDATASection`,`Comment`,`ProcessingInstruction` , 或XPathNamespace节点。如果上下文节点是`Text`或 `CDATASection`然后上下文被解释为 XPath 所见的整个逻辑文本节点，除非该节点为空，在这种情况下它可能不会用作 XPath 上下文。
resolver	IXPathNSResolver	这`解析器`允许翻译所有前缀，包括 `XML`命名空间前缀，在 XPath 表达式中转换为适当的命名空间 URI。如果指定为`无效的` 表达式中的任何命名空间前缀都将导致 `DOMException`被代码抛出`命名空间_错误`.
type	XPathResultType	如果一个特定的`类型`被指定，则返回结果为对应的类型。对于 XPath 1.0 结果，这必须是的值之一`XPathResultType`枚举。
result	Object	这`结果`指定可重复使用并由此方法返回的特定结果对象。如果指定为`无效的`或者实现不重用指定的结果，将构造并返回一个新的结果对象。对于 XPath 1.0 结果，此对象将是类型`IXPathResult`.

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

例外	（健康）状况
DOMException	INVALID_EXPRESSION_ERR：如果表达式根据的规则不合法则引发`IXPathEvaluator`.
DOMException	TYPE_ERR：如果结果无法转换为返回指定类型，则引发。
DOMException	NAMESPACE_ERR：如果表达式包含命名空间前缀无法由指定的解析`IXPathNSResolver`.
DOMException	WRONG_DOCUMENT_ERR：该节点来自一个不受此支持的文档 `IXPathEvaluator`.
DOMException	NOT_SUPPORTED_ERR：该节点不是允许作为 XPath 上下文节点的类型，或者该节点不允许请求类型`IXPathEvaluator`.