метод XML DOM evaluate()

Руководство по объекту Document

определение и использование

метод evaluate() вычисляет XPath-выражение.

грамматика:

evaluate(xpathText,contextNode,namespaceURLMapper,resultType,result)
параметр Описание
xpathText строка, представляющая XPath-выражение, которое нужно вычислить.
contextNode узел в документе, соответствующий выражению, которое нужно вычислить.
namespaceURLMapper

функция, которая ассоциирует префикс пространства имен с полным URL пространства имен.

если такая карта не нужна, то она равна null.

resultType

определяет тип объекта, ожидаемого в результате, с помощью преобразования XPath для принудительного изменения типа результата.

возможные значения типа result могут быть определены константами объекта XPathResult.

result

рециклируемый объект XPathResult;

если вам нужно создать новый объект XPathResult, то он равен null.

возвратное значение

представляет возвращаемое значение выражения, вычисленного на основе заданного узла контекста объект XPathResult

выбрасывать

если xpathText с грамматическими ошибками или если результат выражения не может быть преобразован в желаемый resultTypeили если выражение содержит namespaceURLMapper Невозможно распознать пространство имен, или если contextNode Этот метод выбрасывает исключение, если у него есть неправильный тип или он не связан с этим документом.

Описание

Этот метод вычисляет заданное выражение XPath, основываясь на заданном узле контекста, и возвращает объект XPathResult, который определяет тип результата, который должен быть. Если вам нужно вычислить выражение несколько раз, используйте Document.createExpression() чтобы скомпилировать выражение в Объект XPathExpressionи затем используйте метод evaluate() XPathExpression.

IE не поддерживает этот API. См. Node.selectNodes() И Node.selectSingleNode() Чтобы узнать альтернативный метод, специфичный для IE.

См.

Руководство по объекту Document