XmlAttribute::ReplaceChild Method

Replaces the child node specified with the new child node specified.

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

public:
virtual XmlNode^ ReplaceChild(
	XmlNode^ newChild, 
	XmlNode^ oldChild
) override

Parameters

newChild
Type: System.Xml::XmlNode

The new child XmlNode.

oldChild
Type: System.Xml::XmlNode

The XmlNode to replace.

Return Value

Type: System.Xml::XmlNode
The XmlNode replaced.

ExceptionCondition
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.

The oldChild is not a child of this node.

If the newChild is already in the tree, it is first removed.

If the newChild was created from another document, you can use XmlDocument::ImportNode to import the node to the current document.

For an example of the ReplaceChild method, see the ReplaceChild method.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft