IXPathExpression.Evaluate

IXPathExpression.Evaluate method

Évalue cette expression XPath et renvoie un résultat.

public IXPathResult Evaluate(Node contextNode, XPathResultType type, object result)
ParamètreTaperLa description
contextNodeNodeLecontexte est le nœud de contexte pour l’évaluation de cette expression XPath. Si leIXPathEvaluator a été obtenu en coulant leDocument alors cela doit appartenir au même document et doit être unDocument ,Element ,Attr , Text ,CDATASection ,Comment ,ProcessingInstruction , ouXPathNamespace nœud. Si le nœud de contexte est unText ou unCDATASection, alors le contexte est interprété comme l’ensemble du nœud de texte logique tel qu’il est vu par XPath, sauf si le nœud est vide auquel cas il ne peut pas servir de contexte XPath.
typeXPathResultTypeSi un spécifiquetaper est spécifié, le résultat sera contraint de renvoyer le type spécifié en s’appuyant sur les conversions XPath et échouera si la coercition souhaitée n’est pas possible. Cela doit être l’une des valeurs deXPathResultType.
resultObjectLerésultat spécifie un objet de résultat spécifique qui peut être réutilisé et renvoyé par cette méthode. Si cela est spécifié commenulou si l’implémentation ne réutilise pas le résultat spécifié, un nouvel objet de résultat sera construit et renvoyé. Pour les résultats XPath 1.0, cet objet sera de typeIXPathResult.

Return_Value

Résultat de l’évaluation de l’expression XPath. Pour les résultats XPath 1.0, cet objet sera de typeIXPathResult.

Exceptions

exceptioncondition
DOMExceptionTYPE_ERR : déclenché si le résultat ne peut pas être converti pour renvoyer le type spécifié.
DOMExceptionWRONG_DOCUMENT_ERR : le nœud provient d’un document qui n’est pas pris en charge par leIXPathEvaluator qui a créé ceIXPathExpression.
DOMExceptionNOT_SUPPORTED_ERR : le nœud n’est pas un type autorisé en tant que nœud de contexte XPath ou le type de requête n’est pas autorisé par cetteIXPathExpression.

Voir également