Evaluate

IXPathEvaluator.Evaluate method

Evalúa una cadena de expresión XPath y devuelve un resultado del tipo especificado si es posible.

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)
Parámetro Escribe Descripción
expression String La cadena de expresión XPath que se analizará y evaluará.
contextNode Node loscontexto es un nodo de contexto para la evaluación de esta expresión XPath . Si elIXPathEvaluator se obtuvo lanzando el Document entonces este debe ser propiedad del mismo documento y debe ser un Document ,Element ,Attr ,Text , CDATASection ,Comment ,ProcessingInstruction , oXPathNamespace nodo. Si el nodo de contexto es unText o un CDATASectionel contexto se interpreta como el nodo de texto lógico completo tal como lo ve XPath, a menos que el nodo esté vacío, en cuyo caso puede que no sirva como contexto XPath.
resolver IXPathNSResolver losresolver permite la traducción de todos los prefijos, incluido elxml prefijo de espacio de nombres, dentro de la expresión XPath en los URI de espacio de nombres apropiados. Si esto se especifica comonulo , cualquier prefijo de espacio de nombres dentro de la expresión dará como resultado enDOMException ser arrojado con el códigoESPACIO DE NOMBRES_ERR.
type XPathResultType Si un especificoescribe se especifica, entonces el resultado se devolverá como el tipo correspondiente. Para los resultados de XPath 1.0, este debe ser uno de los valores de XPathResultType enumeración
result Object losresultado especifica un objeto de resultado específico que puede ser reutilizado y devuelto por este método. Si esto se especifica comonulo la implementación no reutiliza el resultado especificado, se construirá y devolverá un nuevo objeto de resultado. Para los resultados de XPath 1.0 , este objeto será del tipoIXPathResult.

Valor_devuelto

El resultado de la evaluación de la expresión XPath. Para los resultados de XPath 1.0, este objeto será del tipoIXPathResult.

Excepciones

excepción condición
DOMException INVALID_EXPRESSION_ERR: Se genera si la expresión no es legal según a las reglas de laIXPathEvaluator.
DOMException TYPE_ERR: se genera si el resultado no se puede convertir para devolver el tipo especificado .
DOMException NAMESPACE_ERR: se genera si la expresión contiene prefijos de espacio de nombres que no pueden ser resueltos por el especificadoIXPathNSResolver.
DOMException WRONG_DOCUMENT_ERR: El nodo es de un documento que no es compatible con esteIXPathEvaluator.
DOMException NOT_SUPPORTED_ERR: el nodo no es un tipo permitido como un contexto XPath nodo o el tipo de solicitud no está permitido por esteIXPathEvaluator.

Ver también