XPathExpression.Evaluateメソッド

説明

XPathの評価を実行します。

呼出形式

var result = expression.Evaluate( node [, type [, result ] ] )

戻り値

評価結果のXPathResultオブジェクト

引数

XmlNode node

評価の起点となるコンテキストノード

integer type

このパラメータは省略可能です。

受け取りたい結果の型を以下から指定します。

定数	説明
XPathResult.ANY_TYPE	XPathの評価結果に応じた型
XPathResult.NUMBER_TYPE	数値型
XPathResult.STRING_TYPE	文字列型
XPathResult.BOOLEAN_TYPE	ブーリアン型
XPathResult.ORDERED_NODE_SNAPSHOT_TYPE	選択されたノード群を文書順にソートしたスナップショット
XPathResult.UNORDERED_NODE_SNAPSHOT_TYPE	選択されたノード群のスナップショット（順序は不定）
XPathResult.ORDERED_NODE_ITERATOR_TYPE	選択されたノード群を文書順にソートしたイテレータ
XPathResult.UNORDERED_NODE_ITERATOR_TYPE	選択されたノード群のイテレータ（順序は不定）
XPathResult.ANY_UNORDERED_NODE_TYPE	選択されたノード群のひとつのノード
XPathResult.FIRST_ORDERED_NODE_TYPE	選択されたノード群の先頭ノード

パラメータを省略するか、ANY_TYPEを指定した場合、XPathの評価結果に応じた型が返ります。評価結果がノードセットとなる場合は、必ずUNORDERED_NODE_ITERATOR_TYPEで返されます。ANY_TYPEが結果として返されることは決してありません。

XPathResult result

XPathResultオブジェクトを再利用する場合に指定します。

このパラメータは省略可能です。

例外

XPath-51

EXPRESSION_ERR

XPath-52

TYPE_ERR

DOM-4

WRONG_DOCUMENT_ERR

DOM-14

NAMESPACE_ERR

使用例

var resolver = XPathEvaluator.CreateNSResolver(node);

var expression = XPathEvaluator.CreateExpression(xpath, resolver);

var result = expression.Evaluate(node);