XNode.DocumentOrderComparer Property

Definition

Namespace:

System.Xml.Linq

Assemblies:

netstandard.dll, System.Xml.XDocument.dll

Source:

XNode.cs

Gets a comparer that can compare the relative position of two nodes.

C#

public static System.Xml.Linq.XNodeDocumentOrderComparer DocumentOrderComparer { get; }

Property Value

XNodeDocumentOrderComparer

An XNodeDocumentOrderComparer that can compare the relative position of two nodes.

Examples

The following example creates an XML tree with some elements. It then creates a List<T> of XNode that contains some elements from the XML tree at random. It sorts the list, using this property to retrieve a XNodeDocumentOrderComparer, which implements the System.Collections.IComparer and System.Collections.Generic.IComparer<T> interfaces.

C#

XElement xmlTree = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5)  
);  

List<XNode> nodeList = new List<XNode>();  
nodeList.Add(xmlTree.Element("Child5"));  
nodeList.Add(xmlTree.Element("Child3"));  
nodeList.Add(xmlTree.Element("Child1"));  

// Sort nodes in document order.  
nodeList.Sort(XNode.DocumentOrderComparer);  

foreach (XElement el in nodeList)  
    Console.WriteLine(el);  

This example produces the following output:

<Child1>1</Child1>  
<Child3>3</Child3>  
<Child5>5</Child5>  

Remarks

This property is primarily used internally for implementing the InDocumentOrder extension method. The recommended approach is to use that extension method instead of using this property directly.

Applies to

See also

• LINQ to XML overview