XmlAttribute::PrependChild Method (XmlNode^)
Adds the specified node to the beginning of the list of child nodes for this node.
Assembly: System.Xml (in System.Xml.dll)
Parameters
- newChild
-
Type:
System.Xml::XmlNode^
The XmlNode to add. If it is an XmlDocumentFragment, the entire contents of the document fragment are moved into the child list of this node.
| Exception | Condition |
|---|---|
| InvalidOperationException | This node is of a type that does not allow child nodes of the type of the newChild node. The newChild is an ancestor of this node. |
| ArgumentException | The newChild was created from a different document than the one that created this node. This node is read-only. |
If the newChild is already in the tree, it is first removed.
If the node being inserted was created from another document, you can use XmlDocument::ImportNode to import the node to the current document. The imported node can then be inserted into the current document.
This method is a Microsoft extension to the Document Object Model (DOM).
For an example of the PrependChild method, see the PrependChild method.
Available since 10
.NET Framework
Available since 2.0