XPathNavigator.ComparePosition メソッド

.NET Framework クラス ライブラリ リファレンス

XPathNavigator.ComparePosition メソッド

現在の XPathNavigator の位置と指定された XPathNavigator の位置を比較します。

名前空間: System.Xml.XPath
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 ComparePosition ( _
    nav As XPathNavigator _
) As XmlNodeOrder

Visual Basic (使用法)

Dim instance As XPathNavigator
Dim nav As XPathNavigator
Dim returnValue As XmlNodeOrder

returnValue = instance.ComparePosition(nav)

C#

public virtual XmlNodeOrder ComparePosition (
    XPathNavigator nav
)

C++

public:
virtual XmlNodeOrder ComparePosition (
    XPathNavigator^ nav
)

J#

public XmlNodeOrder ComparePosition (
    XPathNavigator nav
)

JScript

public function ComparePosition (
    nav : XPathNavigator
) : XmlNodeOrder

パラメータ

nav

比較対象の XPathNavigator。

戻り値
2 つの XPathNavigator オブジェクトの比較位置を表す XmlNodeOrder 値。

解説

XmlNodeOrder 列挙体を次の表に示します。

XmlNodeOrder	説明
Before	この XPathNavigator の現在のノードが、提供された XPathNavigator の現在のノードの前にあります。
After	この XPathNavigator の現在のノードが、提供された XPathNavigator の現在のノードの後にあります。
Same	2 つの XPathNavigator オブジェクトが同じノードに配置されています。
Unknown	ドキュメントの順番についてノードの相対的な位置を判断できないか、または XPathNavigator パラメータとして null 参照 (Visual Basic では Nothing) が指定されています。2 つのノードが別のツリーにある場合に発生します。

ComparePosition メソッドの動作は、XPathNavigator が現在配置されている XPathNodeType によって異なります。XML ドキュメントのノードを比較するときは、次の規則が適用されます。

• Element ノード : ソース ドキュメントからドキュメント順に返されます。

• Namespace ノード : ドキュメント順に返され、常に親要素の Attribute ノードの前にあります。

• Attribute ノード : ドキュメント順に返されます。これらは必ず Namespace ノードの後で、さらに親ノードのすべての子ノードより前に配置されます。

メモ
XPath データ モデルおよび各ノード型の詳細については、http://www.w3.org/TR/xpath#data-model の W3C 勧告『XML Path Language (XPath)』のセクション 5 を参照してください。

このメソッドは、XPathNavigator 状態には影響を与えません。

メモ
可能な場合は、ComparePosition メソッドではなく IsSamePosition メソッドを使用してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
XPathNavigator クラス
XPathNavigator メンバ
System.Xml.XPath 名前空間
IsSamePosition