Evaluate

IXPathEvaluator.Evaluate method

Wertet eine XPath-Ausdruckszeichenfolge aus und gibt, wenn möglich, ein Ergebnis des angegebenen Typs zurück.

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)
Parameter Typ Beschreibung
expression String Die zu analysierende und auszuwertende XPath-Ausdruckszeichenfolge.
contextNode Node DasKontext ist Kontextknoten für die Auswertung dieses XPath-Ausdrucks. Wenn dieIXPathEvaluator wurde durch das Gießen des erhaltenDocument dann muss dies demselben Dokument gehören und ein seinDocument ,Element ,Attr ,Text , CDATASection ,Comment ,ProcessingInstruction , oderXPathNamespace Knoten. Wenn der Kontextknoten aText oder ein CDATASectiondann wird der Kontext als der gesamte logische Textknoten interpretiert, wie er von XPath gesehen wird, es sei denn, der Knoten ist leer, in diesem Fall dient er möglicherweise nicht als XPath-Kontext.
resolver IXPathNSResolver DasResolver ermöglicht die Übersetzung aller Präfixe, einschließlich diexml Namespace-Präfix innerhalb des XPath-Ausdrucks in die entsprechenden Namespace-URIs. Wenn dies angegeben ist alsNull , führt jedes Namespace-Präfix innerhalb des Ausdrucks zu DOMException mit dem Code geworfen werdenNAMESPACE_ERR.
type XPathResultType Wenn eine bestimmteTyp angegeben ist, wird das Ergebnis als des entsprechenden Typs zurückgegeben. Für XPath 1.0-Ergebnisse muss dies einer der Werte von sein.XPathResultType Aufzählung.
result Object DasErgebnis gibt ein bestimmtes Ergebnisobjekt an, das wiederverwendet und von dieser Methode zurückgegeben werden kann. Wenn dies angegeben ist alsNulloder die Implementierung das angegebene Ergebnis nicht wiederverwendet, wird ein neues Ergebnisobjekt erstellt und zurückgegeben. Für XPath 1.0 -Ergebnisse ist dieses Objekt vom TypIXPathResult.

Rückgabewert

Das Ergebnis der Auswertung des XPath-Ausdrucks. Für XPath 1.0-Ergebnisse ist dieses Objekt vom TypIXPathResult.

Ausnahmen

Ausnahme Bedingung
DOMException INVALID_EXPRESSION_ERR: Wird ausgelöst, wenn der Ausdruck gemäß den Regeln des nicht zulässig istIXPathEvaluator.
DOMException TYPE_ERR: Wird ausgelöst, wenn das Ergebnis nicht konvertiert werden kann, um den angegebenen Typ zurückzugeben.
DOMException NAMESPACE_ERR: Wird ausgelöst, wenn der Ausdruck Namespace-Präfixe enthält, die von den angegebenen nicht aufgelöst werden könnenIXPathNSResolver.
DOMException WRONG_DOCUMENT_ERR: Der Knoten stammt aus einem Dokument, das von diesem nicht unterstützt wirdIXPathEvaluator.
DOMException NOT_SUPPORTED_ERR: Der Knoten ist kein Typ, der als XPath-Kontext -Knoten zugelassen ist, oder der Anforderungstyp ist von diesem nicht zugelassenIXPathEvaluator.

Siehe auch