IXPathEvaluator.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ètreTaperLa description
expressionStringLa chaîne d’expression XPath à analyser et à évaluer.
contextNodeNodeLecontexte 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.
resolverIXPathNSResolverLeré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.
typeXPathResultTypeSi 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.
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 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
DOMExceptionINVALID_EXPRESSION_ERR : déclenché si l’expression n’est pas légale selon selon les règles deIXPathEvaluator.
DOMExceptionTYPE_ERR : déclenché si le résultat ne peut pas être converti pour renvoyer le type spécifié .
DOMExceptionNAMESPACE_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.
DOMExceptionWRONG_DOCUMENT_ERR : le nœud provient d’un document qui n’est pas pris en charge par ceIXPathEvaluator.
DOMExceptionNOT_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