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,Инструкцияпообработке, илиXPathNamespacenode. Если узел контекста являетсяTextили CDATASection, тогда контекст интерпретируется как весь логический текстовый узел как его видит XPath, если узел не пуст, и в этом случае он не может служить контекстом XPath.
resolver IXPathNSResolver Преобразователь разрешает перевод всех префиксов, включая префикс пространства имен xml в выражении XPath в соответствующие URI пространства имен. Если это указано как null , любой префикс пространства имен в выражении приведет кDOMExceptionвыбрасывается с кодом NAMESPACE_ERR .
type XPathResultType Если указан конкретный тип , то результат будет возвращен как соответствующий тип. Для результатов XPath 1.0 это должно быть одно из значений перечисления XPathResultTypeenum.
result Object Результат указывает конкретный объект результата, который может быть повторно использован и возвращается этим методом. Если это указано как null или реализация не повторно использует указанный результат, будет создан и возвращен новый объект результата. Для результатов 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.

Смотрите также