インタフェースXPathExpression
public interface XPathExpression
XPathExpressionインタフェースは、解析および解決されたXPath式を表します。
「ドキュメント・オブジェクト・モデル(DOM)レベル3 XPath仕様」も参照してください。
- 導入されたバージョン:
- 1.4、DOMレベル3
-
メソッドのサマリー
-
メソッドの詳細
-
evaluate
このXPath式を評価し、結果を返します。- パラメータ:
contextNode-contextは、このXPath expression.Ifを評価するためのコンテキスト・ノードです。XPathEvaluatorは、Documentをキャストすることで取得され、同じドキュメントによって所有され、Document,Element,Attribute,Text,CDATASection,Comment,ProcessingInstructionまたはXPathNamespacenode.Ifのコンテキストである必要があります。nodeはTextまたはCDATASectionで、そのコンテキストはXPathで表示される論理テキスト・ノード全体として解釈されます。ただし、ノードが空で、その場合はXPathコンテキストとして機能しない場合があります。type- 特定のtypeが指定されている場合、結果はXPath変換に依存して指定された型を返すように強制され、必要な強制が不可能な場合は失敗します。 これは、XPathResultの型コードの1つでなければなりません。result-resultは、このメソッドによって再利用および戻される可能性のある特定の結果オブジェクトを指定します。 これがnullとして指定されている場合、または実装が指定された結果を再利用しない場合、新しい結果オブジェクトが作成され、returned.For XPath 1.0の結果が得られると、このオブジェクトの型はXPathResultになります。- 戻り値:
- XPath expression.For XPath 1.0の結果を評価した結果、このオブジェクトは
XPathResult型になります。 - 例外:
XPathException- TYPE_ERR: 結果を変換して指定された型を返すことができない場合に発生します。DOMException- WRONG_DOCUMENT_ERR: このノードは、このXPathExpressionを作成したXPathEvaluatorによってサポートされていないドキュメントからのものです。
NOT_SUPPORTED_ERR: ノードがXPathコンテキスト・ノードとして許可されているタイプでないか、リクエスト・タイプがこのXPathExpressionで許可されていません。
-