IXPathEvaluator.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ámetroEscribeDescripción
expressionStringLa cadena de expresión XPath que se analizará y evaluará.
contextNodeNodeElcontexto 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.
resolverIXPathNSResolverElresolver 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.
typeXPathResultTypeSi un especificotipo 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
resultObjectElresultado 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óncondición
DOMExceptionINVALID_EXPRESSION_ERR: Se genera si la expresión no es legal según a las reglas de laIXPathEvaluator.
DOMExceptionTYPE_ERR: se genera si el resultado no se puede convertir para devolver el tipo especificado .
DOMExceptionNAMESPACE_ERR: se genera si la expresión contiene prefijos de espacio de nombres que no pueden ser resueltos por el especificadoIXPathNSResolver.
DOMExceptionWRONG_DOCUMENT_ERR: El nodo es de un documento que no es compatible con esteIXPathEvaluator.
DOMExceptionNOT_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