Evaluate

IXPathExpression.Evaluate method

Wertet diesen XPath-Ausdruck aus und gibt ein Ergebnis zurück.

public IXPathResult Evaluate(Node contextNode, XPathResultType type, object result)
ParameterTypBeschreibung
contextNodeNodeDasKontext ist Kontextknoten für die Auswertung dieses XPath-Ausdrucks. Wenn dieIXPathEvaluator wurde durch Gießen der erhaltenDocument dann muss dies im Besitz desselben Dokuments sein und muss a seinDocument ,Element ,Attr , Text ,CDATASection ,Comment ,ProcessingInstruction , oderXPathNamespace Knoten. Wenn der Kontextknoten aText oder einCDATASection, , dann 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.
typeXPathResultTypeWenn eine bestimmteTyp angegeben ist, wird das Ergebnis gezwungen, den angegebenen Typ zurückzugeben, der sich auf XPath-Konvertierungen stützt, und schlägt fehl, wenn die gewünschte Umwandlung nicht möglich ist. Dies muss einer der Werte von seinXPathResultType.
resultObjectDasErgebnis 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 Typ IXPathResult.

Rückgabewert

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

Ausnahmen

AusnahmeBedingung
DOMExceptionTYPE_ERR: Wird ausgelöst, wenn das Ergebnis nicht konvertiert werden kann, um den angegebenen Typ zurückzugeben.
DOMExceptionWRONG_DOCUMENT_ERR: Der Knoten stammt aus einem Dokument, das nicht von unterstützt wirdIXPathEvaluator der das geschaffen hatIXPathExpression.
DOMExceptionNOT_SUPPORTED_ERR: Der Node ist kein Typ, der als XPath-Context-Node zugelassen ist, oder der Anforderungstyp ist von diesem nicht zugelassenIXPathExpression.

Siehe auch