IXPathExpression.Evaluate

IXPathExpression.Evaluate method

Evalueert deze XPath-expressie en retourneert een resultaat.

public IXPathResult Evaluate(Node contextNode, XPathResultType type, object result)
ParameterTypeBeschrijving
contextNodeNodeDecontext is contextknooppunt voor de evaluatie van deze XPath-expressie. Als deIXPathEvaluator werd verkregen door het gieten van deDocument dan moet dit eigendom zijn van hetzelfde document en moet het eenDocument ,Element ,Attr , Text ,CDATASection ,Comment ,ProcessingInstruction , ofXPathNamespace knooppunt. Als het contextknooppunt eenText of eenCDATASection, dan wordt de context geïnterpreteerd als het hele logische tekstknooppunt zoals gezien door XPath, tenzij het knooppunt leeg is , in welk geval het niet kan dienen als de XPath-context.
typeXPathResultTypeAls een specifieketype is opgegeven, wordt het resultaat gedwongen om het door gespecificeerde type te retourneren op basis van XPath-conversies en mislukt het als de gewenste dwang niet mogelijk is. Dit moet een van de waarden zijn vanXPathResultType.
resultObjectDeresultaat specificeert een specifiek resultaatobject dat door deze methode opnieuw kan worden gebruikt en kan worden geretourneerd. Als dit is gespecificeerd alsnulof de implementatie gebruikt het gespecificeerde resultaat niet opnieuw, een nieuw resultaatobject wordt geconstrueerd en geretourneerd. Voor XPath 1.0-resultaten is dit object van het typeIXPathResult.

Winstwaarde

Het resultaat van de evaluatie van de XPath-expressie. Voor XPath 1.0-resultaten is dit object van het typeIXPathResult.

Uitzonderingen

uitzonderingvoorwaarde
DOMExceptionTYPE_ERR: verhoogd als het resultaat niet kan worden geconverteerd om het opgegeven type te retourneren.
DOMExceptionWRONG_DOCUMENT_ERR: het knooppunt komt uit een document dat niet wordt ondersteund door deIXPathEvaluator die dit heeft gemaaktIXPathExpression.
DOMExceptionNOT_SUPPORTED_ERR: het knooppunt is geen type dat is toegestaan als een XPath-contextknooppunt of het verzoektype is hierdoor niet toegestaanIXPathExpression.

Zie ook