IXPathEvaluator.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)
ParameterTypBeschreibung
expressionStringDie zu analysierende und auszuwertende XPath-Ausdruckszeichenfolge.
contextNodeNodeDerKontext 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.
resolverIXPathNSResolverDerResolver 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.
typeXPathResultTypeWenn 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.
resultObjectDerErgebnis 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

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

Siehe auch