.NET Framework Class Library
XmlNode Class
Represents a single node in the XML document.
Inheritance Hierarchy
System.Object
System.Xml.XmlNode
System.Xml.XmlAttribute
System.Xml.XmlDocument
System.Xml.XmlDocumentFragment
System.Xml.XmlEntity
System.Xml.XmlLinkedNode
System.Xml.XmlNotation
Namespace: System.Xml
Assembly: System.Xml (in System.Xml.dll)
Syntax
Visual Basic
Public MustInherit Class XmlNode _ Implements ICloneable, IEnumerable, IXPathNavigable
C#
public abstract class XmlNode : ICloneable, IEnumerable, IXPathNavigable
Visual C++
public ref class XmlNode abstract : ICloneable, IEnumerable, IXPathNavigable
F#
[<AbstractClass>] type XmlNode = class interface ICloneable interface IEnumerable interface IXPathNavigable end
The XmlNode type exposes the following members.
Properties
| Name | Description | |
|---|---|---|
|
Attributes | Gets an XmlAttributeCollection containing the attributes of this node. |
|
|
BaseURI | Gets the base URI of the current node. |
|
|
ChildNodes | Gets all the child nodes of the node. |
|
|
FirstChild | Gets the first child of the node. |
|
|
HasChildNodes | Gets a value indicating whether this node has any child nodes. |
|
|
InnerText | Gets or sets the concatenated values of the node and all its child nodes. |
|
|
InnerXml | Gets or sets the markup representing only the child nodes of this node. |
|
|
IsReadOnly | Gets a value indicating whether the node is read-only. |
|
|
Item[String] | Gets the first child element with the specified Name. |
|
|
Item[String, String] | Gets the first child element with the specified LocalName and NamespaceURI. |
|
|
LastChild | Gets the last child of the node. |
|
|
LocalName | When overridden in a derived class, gets the local name of the node. |
|
|
Name | When overridden in a derived class, gets the qualified name of the node. |
|
|
NamespaceURI | Gets the namespace URI of this node. |
|
|
NextSibling | Gets the node immediately following this node. |
|
|
NodeType | When overridden in a derived class, gets the type of the current node. |
|
|
OuterXml | Gets the markup representing this node and all its child nodes. |
|
|
OwnerDocument | Gets the XmlDocument to which this node belongs. |
|
|
ParentNode | Gets the parent of this node (for nodes that can have parents). |
|
|
Prefix | Gets or sets the namespace prefix of this node. |
|
|
PreviousSibling | Gets the node immediately preceding this node. |
|
|
SchemaInfo | Gets the post schema validation infoset that has been assigned to this node as a result of schema validation. |
|
|
Value | Gets or sets the value of the node. |
Methods
| Name | Description | |
|---|---|---|
|
AppendChild | Adds the specified node to the end of the list of child nodes, of this node. |
|
|
Clone | Creates a duplicate of this node. |
|
|
CloneNode | When overridden in a derived class, creates a duplicate of the node. |
|
|
CreateNavigator | Creates an XPathNavigator for navigating this object. |
|
|
Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
|
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
|
|
GetEnumerator | Provides support for the for each style iteration over the nodes in the XmlNode. |
|
|
GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
|
|
GetNamespaceOfPrefix | Looks up the closest xmlns declaration for the given prefix that is in scope for the current node and returns the namespace URI in the declaration. |
|
|
GetPrefixOfNamespace | Looks up the closest xmlns declaration for the given namespace URI that is in scope for the current node and returns the prefix defined in that declaration. |
|
|
GetType | Gets the Type of the current instance. (Inherited from Object.) |
|
|
InsertAfter | Inserts the specified node immediately after the specified reference node. |
|
|
InsertBefore | Inserts the specified node immediately before the specified reference node. |
|
|
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
|
|
Normalize | Puts all XmlText nodes in the full depth of the sub-tree underneath this XmlNode into a "normal" form where only markup (that is, tags, comments, processing instructions, CDATA sections, and entity references) separates XmlText nodes, that is, there are no adjacent XmlText nodes. |
|
|
PrependChild | Adds the specified node to the beginning of the list of child nodes for this node. |
|
|
RemoveAll | Removes all the child nodes and/or attributes of the current node. |
|
|
RemoveChild | Removes specified child node. |
|
|
ReplaceChild | Replaces the child node oldChild with newChild node. |
|
|
SelectNodes(String) | Selects a list of nodes matching the XPath expression. |
|
|
SelectNodes(String, XmlNamespaceManager) | Selects a list of nodes matching the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied XmlNamespaceManager. |
|
|
SelectSingleNode(String) | Selects the first XmlNode that matches the XPath expression. |
|
|
SelectSingleNode(String, XmlNamespaceManager) | Selects the first XmlNode that matches the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied XmlNamespaceManager. |
|
|
Supports | Test if the DOM implementation implements a specific feature. |
|
|
ToString | Returns a string that represents the current object. (Inherited from Object.) |
|
|
WriteContentTo | When overridden in a derived class, saves all the child nodes of the node to the specified XmlWriter. |
|
|
WriteTo | When overridden in a derived class, saves the current node to the specified XmlWriter. |
Extension Methods
| Name | Description | |
|---|---|---|
|
AsParallel | Enables parallelization of a query. (Defined by ParallelEnumerable.) |
|
|
AsQueryable | Converts an IEnumerable to an IQueryable. (Defined by Queryable.) |
|
|
Cast<TResult> | Converts the elements of an IEnumerable to the specified type. (Defined by Enumerable.) |
|
|
OfType<TResult> | Filters the elements of an IEnumerable based on a specified type. (Defined by Enumerable.) |
Explicit Interface Implementations
| Name | Description | |
|---|---|---|
|
ICloneable.Clone | For a description of this member, see XmlNode.Clone. |
|
|
IEnumerable.GetEnumerator | For a description of this member, see XmlNode.GetEnumerator. |
Remarks
This class implements the W3C Document Object Model (DOM) Level 1 Core and the Core DOM Level 2. The DOM is an in-memory (cache) tree representation of an XML document. XmlNode is the base class in the.NET implementation of the DOM. It supports XPath selections and provides editing capabilities. The XmlDocument class extends XmlNode and represents an XML document. You can use XmlDocument to load and save XML data. It also includes methods for node creation. See XML Document Object Model (DOM) for more information.
Security Note
|
|---|
|
Exceptions raised as a result of using the XmlNode class, such as the XmlException class may contain sensitive information that should not be exposed in untrusted scenarios. Exceptions should be properly handled so that this sensitive information is not exposed in untrusted scenarios. |
Version Information
.NET Framework
Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0.NET Framework Client Profile
Supported in: 4, 3.5 SP1Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
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