IXPathEvaluator.Evaluate

IXPathEvaluator.Evaluate method

XPath 式文字列を評価し、可能であれば指定された型の結果を返します。

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)
パラメータタイプ説明
expressionString解析および評価される XPath 式の文字列。
contextNodeNodeのコンテクストこの XPath 式を評価するためのコンテキスト ノードです。もしIXPathEvaluator をキャストすることによって取得されましたDocument次に、これは同じドキュメントによって所有されている必要があり、 である必要がありますDocument、Element、Attr、Text、 CDATASection、Comment、ProcessingInstruction 、 またはXPathNamespaceノード。コンテキスト ノードがTextまたは CDATASectionの場合、コンテキストは XPath から見た論理テキスト ノード 全体として解釈されます。ただし、ノードが空の場合は XPath コンテキストとして機能しない場合があります。
resolverIXPathNSResolverのリゾルバ を含むすべてのプレフィックスの変換を許可します。xml XPath 式内の名前空間プレフィックスを適切な名前空間 URI に変換します。 と指定した場合ヌル、式内の名前空間プレフィックスは になりますDOMExceptionコードで投げられるNAMESPACE_ERR.
typeXPathResultType特定の場合タイプが指定されている場合、結果は対応する型の として返されます。 XPath 1.0 の結果の場合、これは の値の 1 つでなければなりませんXPathResultType列挙。
resultObjectの結果 再利用され、このメソッドによって返される特定の結果オブジェクトを指定します。これが次のように指定されている場合ヌルまたは実装が指定された結果を 再利用しない場合、新しい結果オブジェクトが構築されて返されます。 XPath 1.0 の結果の場合、このオブジェクトのタイプはIXPathResult.

戻り値

XPath 式の評価の結果。 XPath 1.0 の結果の場合、このオブジェクト のタイプはIXPathResult.

例外

例外調子
DOMExceptionINVALID_EXPRESSION_ERR: の規則に従って式が正当でない場合に発生します。IXPathEvaluator.
DOMExceptionTYPE_ERR: 結果を変換して 指定された型を返すことができない場合に発生します。
DOMExceptionNAMESPACE_ERR: 式に名前空間プレフィックス が含まれている場合に発生します。IXPathNSResolver.
DOMExceptionWRONG_DOCUMENT_ERR: ノードは、これによって がサポートされていないドキュメントからのものですIXPathEvaluator.
DOMExceptionNOT_SUPPORTED_ERR: ノードは XPath コンテキスト ノードとして許可されているタイプではないか、リクエスト タイプがこれによって許可されていませんIXPathEvaluator.

関連項目

IXPathEvaluator.CreateNSResolver