IXPathEvaluator.Evaluate

IXPathEvaluator.Evaluate method

Utvärderar en XPath-uttryckssträng och returnerar ett resultat av den angivna typen om möjligt.

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)
ParameterTypBeskrivning
expressionStringXPath-uttryckssträngen som ska tolkas och utvärderas.
contextNodeNodeDesammanhang är kontextnod för utvärderingen av detta XPath-uttryck. OmIXPathEvaluator erhölls genom att gjuta Document då måste detta ägas av samma dokument och måste vara en Document ,Element ,Attr ,Text , CDATASection ,Comment ,ProcessingInstruction , ellerXPathNamespace nod. Om kontextnoden är enText eller en CDATASectiondå tolkas kontexten som hela den logiska textnoden som ses av XPath, såvida inte noden är tom, i vilket fall den kanske inte fungerar som XPath-kontext.
resolverIXPathNSResolverDeresolver tillåter översättning av alla prefix, inklusive thexml namnområdesprefix, inom XPath-uttrycket till lämpliga namnområdes-URI:er. Om detta anges somnull , kommer alla namnområdesprefix i uttrycket att resultera i DOMException kastas med kodenNAMESPACE_ERR.
typeXPathResultTypeOm en specifiktyp anges, kommer resultatet att returneras som motsvarande typ. För XPath 1.0-resultat måste detta vara ett av värdena för XPathResultType uppräkning.
resultObjectDeresultat anger ett specifikt resultatobjekt som kan återanvändas och returneras med denna metod. Om detta anges somnulleller att implementeringen inte återanvänder det angivna resultatet, kommer ett nytt resultatobjekt att konstrueras och returneras. För XPath 1.0 -resultat kommer detta objekt att vara av typenIXPathResult.

Returvärde

Resultatet av utvärderingen av XPath-uttrycket. För XPath 1.0-resultat kommer detta objekt att vara av typenIXPathResult.

Undantag

undantagskick
DOMExceptionINVALID_EXPRESSION_ERR: Ökas om uttrycket inte är lagligt enligt enligt reglerna iIXPathEvaluator.
DOMExceptionTYPE_ERR: Ökas om resultatet inte kan konverteras för att returnera den angivna typen .
DOMExceptionNAMESPACE_ERR: Ökas om uttrycket innehåller namnområdesprefix som inte kan lösas av den angivnaIXPathNSResolver.
DOMExceptionWRONG_DOCUMENT_ERR: Noden är från ett dokument som inte stöds av dettaIXPathEvaluator.
DOMExceptionNOT_SUPPORTED_ERR: Noden är inte en typ som är tillåten som en XPath-kontext nod eller så är begäranstypen inte tillåten av dennaIXPathEvaluator.

Se även