Biz/Browser 4.0.0
|
|
|||
|
|
|
|
|
|
|
XPathResult |
||
|
|
|||
XPathの結果を保持するクラスです。
XPathEvaluator.Evaluateメソッドまたは、XPathExpression.Evaluateメソッドの戻り値として生成され、XPath構文の評価結果が格納されます。
XPathResultオブジェクトが格納する値にはいくつかの種類の型があり、ResultTypeプロパティが格納している値の型を示しています。値にアクセスするためには格納されている値の型に応じた方法を使う必要があり、型に対して誤ったアクセスを行うとTYPE_ERR例外が発生します。
XPathResultが格納する値の型は以下の通りです。
XPathResult.NUMBER_TYPE
数値型です。NumberValueプロパティでアクセスします。
XPathResult.STRING_TYPE
文字列型です。StringValueプロパティでアクセスします。
XPathResult.BOOLEAN_TYPE
ブーリアン型です。BooleanValueプロパティでアクセスします。
XPathResult.ORDERED_NODE_SNAPSHOT_TYPE
選択されたノード群を文書順にソートしたスナップショットです。SnapshotLengthプロパティとSnapshotItemメソッドでアクセスします。
XPathResult.UNORDERED_NODE_SNAPSHOT_TYPE
選択されたノード群のスナップショットです。順序は不定です。SnapshotLengthプロパティとSnapshotItemメソッドでアクセスします。
XPathResult.ORDERED_NODE_ITERATOR_TYPE
選択されたノード群を文書順にソートしたイテレータです。InvalidIteratorStateプロパティとIterateNextメソッドでアクセスします。
XPathResult.UNORDERED_NODE_ITERATOR_TYPE
選択されたノード群のイテレータです。順序は不定です。InvalidIteratorStateプロパティとIterateNextメソッドでアクセスします。
XPathResult.FIRST_ORDERED_NODE_TYPE
選択されたノード群の先頭ノードです。SingleNodeValueプロパティでアクセスします。
XPathResult.ANY_UNORDERED_NODE_TYPE
選択されたノード群のひとつのノードです。選択されたノード群の内、どのノードが示されるかは不定です。SingleNodeValueプロパティでアクセスします。
XPathResultオブジェクトに格納されている値は、元となったDocumentを更新しても有効です。変更された新しいDocumentによりXPathの再評価が行われることはありません。その結果、再評価を行った場合とは異なる結果が格納されることがあります。また、Documentから削除されたノードを指し続けることがあります。
デフォルトプロパティはありません。ValueTypeの指定は無効です。