XNode Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Represents the abstract concept of a node (element, comment, document type, processing instruction, or text node) in the XML tree.
public ref class XNode abstract : System::Xml::Linq::XObjectpublic abstract class XNode : System.Xml.Linq.XObjecttype XNode = class
inherit XObjectPublic MustInherit Class XNode
Inherits XObject- Inheritance
- Derived
Remarks
XNode is an abstract common base class for the following types:
XContainer is an abstract common base class for the following types:
Objects of classes that derive from XContainer can contain child nodes.
Note
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.
Properties
| BaseUri |
Gets the base URI for this XObject. (Inherited from XObject) |
| Document |
Gets the XDocument for this XObject. (Inherited from XObject) |
| DocumentOrderComparer |
Gets a comparer that can compare the relative position of two nodes. |
| EqualityComparer |
Gets a comparer that can compare two nodes for value equality. |
| NextNode |
Gets the next sibling node of this node. |
| NodeType |
Gets the node type for this XObject. (Inherited from XObject) |
| Parent |
Gets the parent XElement of this XObject. (Inherited from XObject) |
| PreviousNode |
Gets the previous sibling node of this node. |
Methods
| AddAfterSelf(Object) |
Adds the specified content immediately after this node. |
| AddAfterSelf(Object[]) |
Adds the specified content immediately after this node. |
| AddAnnotation(Object) |
Adds an object to the annotation list of this XObject. (Inherited from XObject) |
| AddBeforeSelf(Object) |
Adds the specified content immediately before this node. |
| AddBeforeSelf(Object[]) |
Adds the specified content immediately before this node. |
| Ancestors() |
Returns a collection of the ancestor elements of this node. |
| Ancestors(XName) |
Returns a filtered collection of the ancestor elements of this node. Only elements that have a matching XName are included in the collection. |
| Annotation(Type) |
Gets the first annotation object of the specified type from this XObject. (Inherited from XObject) |
| Annotation<T>() |
Gets the first annotation object of the specified type from this XObject. (Inherited from XObject) |
| Annotations(Type) |
Gets a collection of annotations of the specified type for this XObject. (Inherited from XObject) |
| Annotations<T>() |
Gets a collection of annotations of the specified type for this XObject. (Inherited from XObject) |
| CompareDocumentOrder(XNode, XNode) |
Compares two nodes to determine their relative XML document order. |
| CreateReader() |
Creates an XmlReader for this node. |
| CreateReader(ReaderOptions) |
Creates an XmlReader with the options specified by the |
| DeepEquals(XNode, XNode) |
Compares the values of two nodes, including the values of all descendant nodes. |
| ElementsAfterSelf() |
Returns a collection of the sibling elements after this node, in document order. |
| ElementsAfterSelf(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. |
| ElementsBeforeSelf() |
Returns a collection of the sibling elements before this node, in document order. |
| ElementsBeforeSelf(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. |
| Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
| GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
| GetType() |
Gets the Type of the current instance. (Inherited from Object) |
| IsAfter(XNode) |
Determines if the current node appears after a specified node in terms of document order. |
| IsBefore(XNode) |
Determines if the current node appears before a specified node in terms of document order. |
| MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
| NodesAfterSelf() |
Returns a collection of the sibling nodes after this node, in document order. |
| NodesBeforeSelf() |
Returns a collection of the sibling nodes before this node, in document order. |
| ReadFrom(XmlReader) | |
| ReadFromAsync(XmlReader, CancellationToken) |
Creates an XNode from an XmlReader. The runtime type of the node is determined by the NodeType of the first node encountered in the reader. |
| Remove() |
Removes this node from its parent. |
| RemoveAnnotations(Type) |
Removes the annotations of the specified type from this XObject. (Inherited from XObject) |
| RemoveAnnotations<T>() |
Removes the annotations of the specified type from this XObject. (Inherited from XObject) |
| ReplaceWith(Object) |
Replaces this node with the specified content. |
| ReplaceWith(Object[]) |
Replaces this node with the specified content. |
| ToString() |
Returns the indented XML for this node. |
| ToString(SaveOptions) |
Returns the XML for this node, optionally disabling formatting. |
| WriteTo(XmlWriter) |
Writes this node to an XmlWriter. |
| WriteToAsync(XmlWriter, CancellationToken) |
Writes the current node to an XmlWriter. |
Events
| Changed |
Raised when this XObject or any of its descendants have changed. (Inherited from XObject) |
| Changing |
Raised when this XObject or any of its descendants are about to change. (Inherited from XObject) |
Explicit Interface Implementations
| IXmlLineInfo.HasLineInfo() |
Gets a value indicating whether or not this XObject has line information. (Inherited from XObject) |
| IXmlLineInfo.LineNumber |
Gets the line number that the underlying XmlReader reported for this XObject. (Inherited from XObject) |
| IXmlLineInfo.LinePosition |
Gets the line position that the underlying XmlReader reported for this XObject. (Inherited from XObject) |
Extension Methods
| CreateNavigator(XNode, XmlNameTable) |
Creates an XPathNavigator for an XNode. The XmlNameTable enables more efficient XPath expression processing. |
| CreateNavigator(XNode) |
Creates an XPathNavigator for an XNode. |
| XPathEvaluate(XNode, String, IXmlNamespaceResolver) |
Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. |
| XPathEvaluate(XNode, String) |
Evaluates an XPath expression. |
| XPathSelectElement(XNode, String, IXmlNamespaceResolver) |
Selects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. |
| XPathSelectElement(XNode, String) |
Selects an XElement using a XPath expression. |
| XPathSelectElements(XNode, String, IXmlNamespaceResolver) |
Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver. |
| XPathSelectElements(XNode, String) |
Selects a collection of elements using an XPath expression. |
| ToXPathNavigable(XNode) |
Returns an accessor that allows you to navigate and edit the specified XNode. |
