XNode.DeepEquals Method (XNode, XNode)


Compares the values of two nodes, including the values of all descendant nodes.

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

Public Shared Function DeepEquals (
	n1 As XNode,
	n2 As XNode
) As Boolean


Type: System.Xml.Linq.XNode

The first XNode to compare.

Type: System.Xml.Linq.XNode

The second XNode to compare.

Return Value

Type: System.Boolean

true if the nodes are equal; otherwise false.

The following criteria determine whether two nodes are equal:

  • A null node is equal to another null node but unequal to a non-null node.

  • Two XNode objects of different types are never equal.

  • Two XText nodes are equal if they contain the same text.

  • Two XElement nodes are equal if they have the same tag name, the same set of attributes with the same values, and (ignoring comments and processing instructions) contain two equal length sequences of equal content nodes.

  • Two XDocument nodes are equal if their root nodes are equal.

  • Two XComment nodes are equal if they contain the same comment text.

  • Two XProcessingInstruction nodes are equal if they have the same target and data.

  • Two XDocumentType nodes are equal if the have the same name, public ID, system ID, and internal subset.

The following example uses this method to compare two XML trees.

                Dim xmlTree1 As XElement = _ 
        <Root Att1="1" Att2="2">
            <Child2>some content</Child2>

Dim xmlTree2 As XElement = _ 
        <Root Att1="1" Att2="2">
            <Child2>some content</Child2>

Console.WriteLine(XNode.DeepEquals(xmlTree1, xmlTree2))

This example produces the following output:


Universal Windows Platform
Available since 8
.NET Framework
Available since 3.5
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top