IXPathEvaluator.Evaluate

IXPathEvaluator.Evaluate method

Evalueert een XPath-expressietekenreeks en retourneert indien mogelijk een resultaat van het opgegeven type.

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)
ParameterTypeBeschrijving
expressionStringDe tekenreeks voor de XPath-expressie die moet worden geparseerd en geëvalueerd.
contextNodeNodeDecontext is contextknooppunt voor de evaluatie van deze XPath-expressie. Als deIXPathEvaluator werd verkregen door de te castenDocument dan moet dit eigendom zijn van hetzelfde document en moet het een zijnDocument ,Element ,Attr ,Text , CDATASection ,Comment ,ProcessingInstruction , ofXPathNamespace knooppunt. Als het contextknooppunt eenText of een CDATASectiondan wordt de context geïnterpreteerd als het hele logische tekstknooppunt zoals gezien door XPath, tenzij het knooppunt leeg is, in welk geval het mogelijk niet dient als de XPath-context.
resolverIXPathNSResolverDeoplosser staat vertaling van alle prefixen toe, inclusief thexml naamruimtevoorvoegsel, binnen de XPath-expressie in de juiste naamruimte-URI’s. Als dit is opgegeven alsnul , zal elk naamruimtevoorvoegsel binnen de uitdrukking resulteren in DOMException met de code worden gegooidNAMESPACE_ERR.
typeXPathResultTypeAls een specifieketype is opgegeven, wordt het resultaat geretourneerd als het overeenkomstige type. Voor XPath 1.0-resultaten moet dit een van de waarden zijn van de XPathResultType opsomming.
resultObjectDeresultaat specificeert een specifiek resultaatobject dat kan worden hergebruikt en geretourneerd door deze methode. Als dit is gespecificeerd alsnulof de implementatie hergebruikt het opgegeven resultaat niet , een nieuw resultaatobject wordt geconstrueerd en geretourneerd. Voor XPath 1.0 resultaten zal dit object van het type zijnIXPathResult.

Winstwaarde

Het resultaat van de evaluatie van de XPath-expressie. Voor XPath 1.0-resultaten zal dit object van het type zijnIXPathResult.

Uitzonderingen

uitzonderingvoorwaarde
DOMExceptionINVALID_EXPRESSION_ERR: Verhoogd als de uitdrukking niet legaal is volgens volgens de regels van deIXPathEvaluator.
DOMExceptionTYPE_ERR: verhoogd als het resultaat niet kan worden geconverteerd om het door gespecificeerde type te retourneren.
DOMExceptionNAMESPACE_ERR: Verhoogd als de expressie naamruimtevoorvoegsels bevat die niet kunnen worden opgelost door de opgegevenIXPathNSResolver.
DOMExceptionWRONG_DOCUMENT_ERR: het knooppunt komt uit een document dat hierdoor niet wordt ondersteundIXPathEvaluator.
DOMExceptionNOT_SUPPORTED_ERR: het knooppunt is geen type dat is toegestaan als een XPath-context -knooppunt of het verzoektype is hierdoor niet toegestaanIXPathEvaluator.

Zie ook

IXPathEvaluator.CreateNSResolver