IXPathExpression.Evaluate

IXPathExpression.Evaluate method

Evalúa esta expresión XPath y devuelve un resultado.

public IXPathResult Evaluate(Node contextNode, XPathResultType type, object result)
ParámetroEscribeDescripción
contextNodeNodeElcontexto es un nodo de contexto para la evaluación de esta expresión XPath. Si elIXPathEvaluator se obtuvo echando elDocument entonces esto debe ser propiedad del mismo documento y debe ser unDocument ,Element ,Attr , Text ,CDATASection ,Comment ,ProcessingInstruction , oXPathNamespace nodo. Si el nodo de contexto es unText o unCDATASection, , el 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 es posible que no sirva como contexto XPath.
typeXPathResultTypeSi un especificotipo se especifica, entonces el resultado será obligado a devolver el tipo especificado basándose en las conversiones de XPath y fallará si la coerción deseada no es posible. Este debe ser uno de los valores deXPathResultType.
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á de tipoIXPathResult.

Valor_devuelto

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

Excepciones

excepcióncondición
DOMExceptionTYPE_ERR: se genera si el resultado no se puede convertir para devolver el tipo especificado.
DOMExceptionWRONG_DOCUMENT_ERR: El nodo es de un documento que no es compatible con elIXPathEvaluator que creó estoIXPathExpression.
DOMExceptionNOT_SUPPORTED_ERR: el nodo no es un tipo permitido como nodo de contexto XPath o el tipo de solicitud no está permitido por esteIXPathExpression.

Ver también