IXPathExpression.Evaluate

IXPathExpression.Evaluate method

Оценивает это выражение XPath и возвращает результат.

public IXPathResult Evaluate(Node contextNode, XPathResultType type, object result)
ПараметрТипОписание
contextNodeNodeконтекст является контекстным узлом для оценки этого выражения XPath. ЕслиIXPathEvaluator был получен отливкойDocument то он должен принадлежать тому же документу и должен бытьDocument ,Element ,Attr , Text ,CDATASection ,Comment ,ProcessingInstruction , илиXPathNamespace узел. Если узел контекста являетсяText илиCDATASection, , то контекст интерпретируется как весь логический текстовый узел, видимый XPath, если только узел не является пустым , и в этом случае он не может служить контекстом XPath.
typeXPathResultTypeЕсли конкретныйтип указан, то результат будет принудительно возвращать указанный тип , полагаясь на преобразования XPath, и потерпит неудачу, если желаемое принуждение невозможно. Это должно быть одним из значенийXPathResultType.
resultObjectрезультат указывает конкретный объект результата, который может быть повторно использован и возвращен этим методом. Если это указано какнулевойили реализация не использует повторно указанный результат , будет создан и возвращен новый объект результата. Для результатов XPath 1.0 этот объект будет иметь тип IXPathResult.

Возвращаемое значение

Результат вычисления выражения XPath. Для результатов XPath 1.0 этот объект будет иметь тип IXPathResult.

Исключения

исключениеусловие
DOMExceptionTYPE_ERR: Возникает, если результат не может быть преобразован для возврата указанного типа.
DOMExceptionWRONG_DOCUMENT_ERR: узел взят из документа, который не поддерживается IXPathEvaluator который создал этоIXPathExpression.
DOMExceptionNOT_SUPPORTED_ERR: Тип узла не разрешен в качестве узла контекста XPath , или тип запроса не разрешен этимIXPathExpression.

Смотрите также