XNode::CompareDocumentOrder Method (XNode^, XNode^)
Compares two nodes to determine their relative XML document order.
Assembly: System.Xml.Linq (in System.Xml.Linq.dll)
Parameters
- n1
-
Type:
System.Xml.Linq::XNode^
First XNode to compare.
- n2
-
Type:
System.Xml.Linq::XNode^
Second XNode to compare.
Return Value
Type: System::Int32An int containing 0 if the nodes are equal; -1 if n1 is before n2; 1 if n1 is after n2.
| Exception | Condition |
|---|---|
| InvalidOperationException | The two nodes do not share a common ancestor. |
The XContainer stores its child nodes as a singly-linked list of XNode objects. This means that the CompareDocumentOrder method must traverse the ancestors of the two nodes being compared until it finds the common parent. Then it must traverse the list of the common parent’s child nodes to determine the order of the two nodes being compared. Therefore, using this method might affect your performance.
Available since 8
.NET Framework
Available since 3.5
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1