metoda XML DOM evaluate()

Podręcznik dokumentacji obiektu Document

definicja i użycie

metoda evaluate() oblicza wyrażenie XPath.

gramatyka:

evaluate(xpathText,contextNode,namespaceURLMapper,resultType,result)
parametr Opis
xpathText znakowy ciąg reprezentujący wyrażenie XPath do obliczenia.
contextNode w dokumencie, węzeł odpowiadający wyrażeniu do obliczenia.
namespaceURLMapper

funkcja mapująca prefiks przestrzeni nazw na pełny adres URL przestrzeni nazw.

jeśli nie jest potrzebna taka mapowanie, to null.

resultType

określa typ obiektu oczekiwanego jako wynik, używając przekształceń XPath do wymuszenia typu wyniku.

możliwe wartości typu result to stałe zdefiniowane przez obiekt XPathResult.

result

obiekt XPathResult do wielokrotnego użycia;

jeśli chcesz utworzyć nowy obiekt XPathResult, to null.

zdefiniowane dla podanego węzła kontekstu.

oznacza wartość zwróconą przez wyrażenie obliczeniowe obiekt XPathResult

wyrzuca

jeśli xpathText zawiera błędy gramatyczne, lub jeśli wynik wyrażenia nie może być przekształcony do oczekiwanego resultTypelub jeśli wyrażenie zawiera namespaceURLMapper nie można zinterpretować przestrzeni nazw, lub jeśli contextNode metoda wyrzuca wyjątek, jeśli ma błędny typ lub nie jest związana z tym dokumentem.

Opis

Ta metoda oblicza określone wyrażenie XPath na podstawie podanego węzła kontekstu i zwraca obiekt XPathResult, który określa, jaki powinien być typ wyniku. Jeśli chcesz wielokrotnie obliczać to wyrażenie, użyj Document.createExpression() aby skompilować wyrażenie do Obiekt XPathExpressioni następnie użyj metody evaluate() XPathExpression.

IE nie obsługuje tego API. Zobacz Node.selectNodes() i Node.selectSingleNode() Aby uzyskać alternatywną metodę specyficzną dla IE.

Zobacz

Podręcznik dokumentacji obiektu Document