Evaluate

IXPathEvaluator.Evaluate method

Évalue une chaîne d’expression XPath et renvoie un résultat du type spécifié si possible.

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)
Paramètre Taper La description
expression String La chaîne d’expression XPath à analyser et à évaluer.
contextNode Node Lale contexte est le nœud de contexte pour l’évaluation de cette expression XPath . Si laIXPathEvaluator a été obtenu en jetant le Document alors cela doit appartenir au même document et doit être un Document ,Element ,Attr ,Text , CDATASection ,Comment ,ProcessingInstruction , ouXPathNamespace nœud. Si le nœud de contexte est unText ou un CDATASectionalors le contexte est interprété comme le nœud de texte logique entier tel qu’il est vu par XPath, sauf si le nœud est vide, auquel cas il ne peut pas servir de contexte XPath.
resolver IXPathNSResolver Larésolveur permet la traduction de tous les préfixes, y compris leXML préfixe d’espace de noms, dans l’expression XPath dans les URI d’espace de noms appropriés. Si cela est spécifié commenul , tout préfixe d’espace de noms dans l’expression entraînera dansDOMException être jeté avec le codeNAMESPACE_ERR.
type XPathResultType Si un spécifiquetaper est spécifié, le résultat sera renvoyé sous la forme le type correspondant. Pour les résultats XPath 1.0, il doit s’agir de l’une des valeurs de XPathResultType énumération.
result Object Laré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 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

exception condition
DOMException INVALID_EXPRESSION_ERR : déclenché si l’expression n’est pas légale selon selon les règles deIXPathEvaluator.
DOMException TYPE_ERR : déclenché si le résultat ne peut pas être converti pour renvoyer le type spécifié .
DOMException NAMESPACE_ERR : déclenché si l’expression contient des préfixes d’espace de noms qui ne peuvent pas être résolus par le spécifiéIXPathNSResolver.
DOMException WRONG_DOCUMENT_ERR : le nœud provient d’un document qui n’est pas pris en charge par ceIXPathEvaluator.
DOMException NOT_SUPPORTED_ERR : le nœud n’est pas un type autorisé en tant que nœud de contexte XPath ou le type de demande n’est pas autorisé par cetteIXPathEvaluator.

Voir également