Export (0) Print
Expand All

XPathNavigator.ComparePosition Method

Compares the position of the current XPathNavigator with the position of the XPathNavigator specified.

Namespace:  System.Xml.XPath
Assembly:  System.Xml (in System.Xml.dll)

public virtual XmlNodeOrder ComparePosition(
	XPathNavigator nav
)

Parameters

nav
Type: System.Xml.XPath.XPathNavigator

The XPathNavigator to compare against.

Return Value

Type: System.Xml.XmlNodeOrder
An XmlNodeOrder value representing the comparative position of the two XPathNavigator objects.

The following table describes the XmlNodeOrder enumeration.

XmlNodeOrder

Description

Before

The current node of this XPathNavigator is before the current node of the supplied XPathNavigator.

After

The current node of this XPathNavigator is after the current node of the supplied XPathNavigator.

Same

The two XPathNavigator objects are positioned on the same node.

Unknown

The node positions cannot be determined relative to each other in the document order, or null is specified as the XPathNavigator parameter. This could occur if the two nodes reside in different trees.

The ComparePosition method's behavior is dependent on the XPathNodeType the XPathNavigator is currently positioned on. When comparing nodes in the XML document, the following rules apply:

  • Element nodes: These nodes are returned in document order from the source document.

  • Namespace nodes: These nodes may be returned in document order and are always before the Attribute nodes of the parent element.

  • Attribute nodes: These nodes may be returned in document order. They always come after the Namespace nodes and before any child nodes of the parent node.

NoteNote

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 located at http://www.w3.org/TR/xpath#data-model.

This method has no effect on the state of the XPathNavigator.

NoteNote

Use the IsSamePosition method rather than the ComparePosition method when possible.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft