XML DOM evaluate() Methode

Dokument-Objekt Referenzhandbuch

Definition und Verwendung

Die evaluate() Methode berechnet einen XPath-Ausdruck.

Syntax:

evaluate(xpathText,contextNode,namespaceURLMapper,resultType,result)
Parameter Beschreibung
xpathText Zeichenkette, die den zu berechnenden XPath-Ausdruck darstellt.
contextNode Knoten im Dokument, der dem auszuführenden Ausdruck entspricht.
namespaceURLMapper

funktioniert, einen Namensraumpräfix in eine vollständige Namensraum-URL zu verknüpfen.

wenn keine solche Abbildung erforderlich ist, dann ist es null.

resultType

bestimmt den Typ des als Ergebnis erwarteten Objekts und erzwingt die Ergebnistyp durch XPath-Transformation.

mögliche Werte des Typs result sind die Konstanten, die vom XPathResult-Objekt definiert werden.

result

ein wiederverwendbares XPathResult-Objekt;

wenn Sie ein neues XPathResult-Objekt erstellen möchten, dann ist es null.

Rückgabewert

stellt einen XPathResult-Objekt

werfen

wenn xpathText Grammatikfehler enthält oder wenn das Ergebnis des Ausdrucks nicht in den gewünschten umgewandelt werden kann. resultTypeoder wenn der Ausdruck namespaceURLMapper unauflösbarer Namespace oder wenn contextNode mit einem falschen Typ oder wenn es nicht mit diesem Dokument zusammenhängt, wirft diese Methode eine Ausnahme aus.

Beschreibung

Diese Methode berechnet das angegebene XPath-Präfix basierend auf dem gegebenen Kontextknoten und gibt ein XPathResult-Objekt zurück, das durch den Typ 'type' bestimmt, was der Ergebnistyp sein sollte. Wenn du einen Ausdruck mehrmals berechnen möchtest, verwende Document.createExpression() um den Ausdruck in einen XPathExpression-Objektdann verwende die Methode evaluate() der XPathExpression.

IE unterstützt diesen API nicht. Siehe Node.selectNodes() und Node.selectSingleNode() um eine spezifische Alternative für IE zu erfahren.

Siehe

Dokument-Objekt Referenzhandbuch