XNode.ReplaceWith Method (Object)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Replaces this node with the specified content.
Namespace: System.Xml.Linq
Assembly: System.Xml.Linq (in System.Xml.Linq.dll)
Syntax
'Declaration
Public Sub ReplaceWith ( _
content As Object _
)
public void ReplaceWith(
Object content
)
Parameters
- content
Type: System.Object
Content that replaces this node.
Remarks
This method first removes this node from its parent, and then adds the specified content to this node's parent, in the place of this node.
For details about the valid content that can be passed to this function, see Valid Content of XElement and XDocument Objects in the .NET Framework documentation.
Examples
The following example uses this method to replace the contents of a node with different content.
XElement xmlTree = new XElement("Root",
new XElement("Child1", "child1 content"),
new XElement("Child2", "child2 content"),
new XElement("Child3", "child3 content"),
new XElement("Child4", "child4 content"),
new XElement("Child5", "child5 content")
);
XElement child3 = xmlTree.Element("Child3");
child3.ReplaceWith(
new XElement("NewChild", "new content")
);
Dim xmlTree As XElement = _
<Root>
<Child1>child1 content</Child1>
<Child2>child2 content</Child2>
<Child3>child3 content</Child3>
<Child4>child4 content</Child4>
<Child5>child5 content</Child5>
</Root>
Dim child3 As XElement = xmlTree.<Child3>(0)
child3.ReplaceWith(<NewChild>new content</NewChild>)
Version Information
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
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
See Also