Export (0) Print
Expand All

XNode Class

Represents the abstract concept of a node (one of: element, comment, document type, processing instruction, or text node) in the XML tree.

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

public abstract class XNode : XObject

The XNode type exposes the following members.

  NameDescription
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360BaseUriGets the base URI for this XObject. (Inherited from XObject.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360DocumentGets the XDocument for this XObject. (Inherited from XObject.)
Public propertyStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360DocumentOrderComparerGets a comparer that can compare the relative position of two nodes.
Public propertyStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360EqualityComparerGets a comparer that can compare two nodes for value equality.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360NextNodeGets the next sibling node of this node.
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360NodeTypeGets the node type for this XObject. (Inherited from XObject.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360ParentGets the parent XElement of this XObject. (Inherited from XObject.)
Public propertySupported by Silverlight for Windows PhoneSupported by Xbox 360PreviousNodeGets the previous sibling node of this node.
Top

  NameDescription
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360AddAfterSelf(Object)Adds the specified content immediately after this node.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360AddAfterSelf(Object[])Adds the specified content immediately after this node.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360AddAnnotationAdds an object to the annotation list of this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360AddBeforeSelf(Object)Adds the specified content immediately before this node.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360AddBeforeSelf(Object[])Adds the specified content immediately before this node.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360Ancestors()Returns a collection of the ancestor elements of this node.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360Ancestors(XName)Returns a filtered collection of the ancestor elements of this node. Only elements that have a matching XName are included in the collection.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360Annotation(Type)Gets the first annotation object of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360Annotation<T>()Get the first annotation object of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360Annotations(Type)Gets a collection of annotations of the specified type for this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360Annotations<T>()Gets a collection of annotations of the specified type for this XObject. (Inherited from XObject.)
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360CompareDocumentOrderCompares two nodes to determine their relative XML document order.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360CreateReader()Creates an XmlReader for this node.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360CreateReader(ReaderOptions)Creates an XmlReader for this node.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360DeepEqualsCompares the values of two nodes, including the values of all descendant nodes.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360ElementsAfterSelf()Returns a collection of the sibling elements after this node, in document order.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360ElementsAfterSelf(XName)Returns a filtered collection of the sibling elements after this node, in document order. Only elements that have a matching XName are included in the collection.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360ElementsBeforeSelf()Returns a collection of the sibling elements before this node, in document order.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360ElementsBeforeSelf(XName)Returns a filtered collection of the sibling elements before this node, in document order. Only elements that have a matching XName are included in the collection.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360Equals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows PhoneSupported by Xbox 360FinalizeAllows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360GetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360IsAfterDetermines if the current node appears after a specified node in terms of document order.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360IsBeforeDetermines if the current node appears before a specified node in terms of document order.
Protected methodSupported by Silverlight for Windows PhoneSupported by Xbox 360MemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360NodesAfterSelfReturns a collection of the sibling nodes after this node, in document order.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360NodesBeforeSelfReturns a collection of the sibling nodes before this node, in document order.
Public methodStatic memberSupported by Silverlight for Windows PhoneSupported by Xbox 360ReadFromCreates an XNode from an XmlReader.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360RemoveRemoves this node from its parent.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360RemoveAnnotations(Type)Removes the annotations of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360RemoveAnnotations<T>()Removes the annotations of the specified type from this XObject. (Inherited from XObject.)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360ReplaceWith(Object)Replaces this node with the specified content.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360ReplaceWith(Object[])Replaces this node with the specified content.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360ToString()Returns the indented XML for this node. (Overrides Object.ToString().)
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360ToString(SaveOptions)Returns the XML for this node, optionally disabling formatting.
Public methodSupported by Silverlight for Windows PhoneSupported by Xbox 360WriteToWrites this node to an XmlWriter.
Top

  NameDescription
Public eventSupported by Silverlight for Windows PhoneSupported by Xbox 360ChangedRaised when this XObject or any of its descendants have changed. (Inherited from XObject.)
Public eventSupported by Silverlight for Windows PhoneSupported by Xbox 360ChangingRaised when this XObject or any of its descendants are about to change. (Inherited from XObject.)
Top

  NameDescription
Public Extension MethodCreateNavigator()Overloaded. Creates an XPathNavigator for an XNode. (Defined by Extensions.)
Public Extension MethodCreateNavigator(XmlNameTable)Overloaded. Creates an XPathNavigator for an XNode. The XmlNameTable enables more efficient XPath expression processing. (Defined by Extensions.)
Public Extension MethodXPathEvaluate(String)Overloaded. Evaluates an XPath expression. (Defined by Extensions.)
Public Extension MethodXPathEvaluate(String, IXmlNamespaceResolver)Overloaded. Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. (Defined by Extensions.)
Public Extension MethodXPathSelectElement(String)Overloaded. Selects an XElement using a XPath expression. (Defined by Extensions.)
Public Extension MethodXPathSelectElement(String, IXmlNamespaceResolver)Overloaded. Selects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. (Defined by Extensions.)
Public Extension MethodXPathSelectElements(String)Overloaded. Selects a collection of elements using an XPath expression. (Defined by Extensions.)
Public Extension MethodXPathSelectElements(String, IXmlNamespaceResolver)Overloaded. Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. (Defined by Extensions.)
Top

  NameDescription
Explicit interface implemetationPrivate methodSupported by Silverlight for Windows PhoneSupported by Xbox 360IXmlLineInfo.HasLineInfoGets a value indicating whether or not this XObject has line information. (Inherited from XObject.)
Explicit interface implemetationPrivate propertySupported by Silverlight for Windows PhoneSupported by Xbox 360IXmlLineInfo.LineNumberGets the line number that the underlying XmlReader reported for this XObject. (Inherited from XObject.)
Explicit interface implemetationPrivate propertySupported by Silverlight for Windows PhoneSupported by Xbox 360IXmlLineInfo.LinePositionGets the line position that the underlying XmlReader reported for this XObject. (Inherited from XObject.)
Top

XNode is an abstract common base class for:

XContainer is an abstract common base class for:

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

NoteNote:

An XAttribute is not an XNode. Attributes are maintained as a list of name/value pairs on an element.

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.

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.


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();


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

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

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

Community Additions

ADD
Show:
© 2014 Microsoft