• csharp
• vb

Inheritance Hierarchy

System.Object
System.Xml.Linq.XObject
System.Xml.Linq.XNode
System.Xml.Linq.XComment
System.Xml.Linq.XContainer
System.Xml.Linq.XDocumentType
System.Xml.Linq.XProcessingInstruction
System.Xml.Linq.XText

Syntax

'Declaration
Public MustInherit Class XNode _
 Inherits XObject

public abstract class XNode : XObject

Properties

Top

Methods

Top

Events

Top

Extension Methods

Top

Explicit Interface Implementations

Top

Remarks

XNode is an abstract common base class for:

• XComment

• XContainer

• XDocumentType

• XProcessingInstruction

• XText

XContainer is an abstract common base class for:

• XDocument

• XElement

Objects of classes that derive from XContainer can contain children nodes.

If you are writing a complex XML application, such as an XML editor or a word processor that stores content as XML, you will often work at the node level. Typical activities when working at the node level include adding nodes, deleting nodes, transforming nodes, and iterating through axes that return collections of 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.

Dim output As New StringBuilder
Dim xmlTree As XElement = _
 <Root>
 <Child1>1</Child1>
 <Child2>2</Child2>
 <Child3>3</Child3>
 <Child4>4</Child4>
 <Child5>5</Child5>
 </Root>
Dim nodeDictionary As Dictionary(Of XNode, String) = New Dictionary(Of XNode, String)(XNode.EqualityComparer)
nodeDictionary.Add(xmlTree.Element("Child5"), "Child 5 Information")
nodeDictionary.Add(xmlTree.Element("Child3"), "Child 3 Information")
nodeDictionary.Add(xmlTree.Element("Child1"), "Child 1 Information")
Dim str As String = nodeDictionary(xmlTree.Element("Child3"))
output.Append(str)
output.Append(Environment.NewLine)
OutputTextBlock.Text = output.ToString()

StringBuilder output = new StringBuilder();
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)
 output.Append(el + Environment.NewLine);
OutputTextBlock.Text = output.ToString();

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Other Resources