XPathNavigator.ComparePosition(XPathNavigator) メソッド

定義

現在の XPathNavigator の位置と指定された XPathNavigator の位置を比較します。Compares the position of the current XPathNavigator with the position of the XPathNavigator specified.

public:
 virtual System::Xml::XmlNodeOrder ComparePosition(System::Xml::XPath::XPathNavigator ^ nav);
public virtual System.Xml.XmlNodeOrder ComparePosition (System.Xml.XPath.XPathNavigator? nav);
public virtual System.Xml.XmlNodeOrder ComparePosition (System.Xml.XPath.XPathNavigator nav);
abstract member ComparePosition : System.Xml.XPath.XPathNavigator -> System.Xml.XmlNodeOrder
override this.ComparePosition : System.Xml.XPath.XPathNavigator -> System.Xml.XmlNodeOrder
Public Overridable Function ComparePosition (nav As XPathNavigator) As XmlNodeOrder

パラメーター

nav
XPathNavigator

比較対象の XPathNavigatorThe XPathNavigator to compare against.

戻り値

XmlNodeOrder

2 つの XmlNodeOrder オブジェクトの比較位置を表す XPathNavigator 値。An XmlNodeOrder value representing the comparative position of the two XPathNavigator objects.

注釈

列挙体の説明を次の表に示し XmlNodeOrder ます。The following table describes the XmlNodeOrder enumeration.

XmlNodeOrderXmlNodeOrder 説明Description
Before このの現在のノード XPathNavigator が、指定されたの現在のノードの前にあり XPathNavigator ます。The current node of this XPathNavigator is before the current node of the supplied XPathNavigator.
After このの現在のノード XPathNavigator が、指定されたの現在のノードの後にあり XPathNavigator ます。The current node of this XPathNavigator is after the current node of the supplied XPathNavigator.
Same 2つの XPathNavigator オブジェクトが同じノード上に配置されます。The two XPathNavigator objects are positioned on the same node.
Unknown ドキュメント順では、ノードの位置を互いに相対的に特定することはできません。また、パラメーターとして指定することもでき null XPathNavigator ます。The node positions cannot be determined relative to each other in the document order, or null is specified as the XPathNavigator parameter. 2 つのノードが別のツリーにある場合は比較できます。This could occur if the two nodes reside in different trees.

ComparePositionメソッドの動作は、 XPathNodeType 現在のが配置されているに依存し XPathNavigator ます。The ComparePosition method's behavior is dependent on the XPathNodeType the XPathNavigator is currently positioned on. XML ドキュメント内のノードを比較する場合、次の規則が適用されます。When comparing nodes in the XML document, the following rules apply:

  • Element ノード: これらのノードは、ソースドキュメントからドキュメント順に返されます。Element nodes: These nodes are returned in document order from the source document.

  • Namespace ノード: これらのノードはドキュメントの順序で返される場合があり、常に親要素のノードの前に配置され Attribute ます。Namespace nodes: These nodes may be returned in document order and are always before the Attribute nodes of the parent element.

  • Attribute ノード: これらのノードは、ドキュメントの順序で返される場合があります。Attribute nodes: These nodes may be returned in document order. これらは常に、ノードの後、 Namespace 親ノードの子ノードの前に配置されます。They always come after the Namespace nodes and before any child nodes of the parent node.

注意

XPath データモデルの詳細および各ノードの種類の詳細については、W3C 勧告『 XML Path Language (xpath) 』のセクション5を参照してください。For more information about the XPath data model and details about each of the node types, see section 5 of the W3C XML Path Language (XPath) recommendation.

このメソッドは、の状態には影響しません XPathNavigatorThis method has no effect on the state of the XPathNavigator.

注意

可能な場合は、メソッドで IsSamePosition はなくメソッドを使用し ComparePosition ます。Use the IsSamePosition method rather than the ComparePosition method when possible.

適用対象

こちらもご覧ください