Export (0) Print
Expand All

XmlNode.RemoveChild Method

Removes specified child node.

[Visual Basic]
Public Overridable Function RemoveChild( _
   ByVal oldChild As XmlNode _
) As XmlNode
[C#]
public virtual XmlNode RemoveChild(
 XmlNode oldChild
);
[C++]
public: virtual XmlNode* RemoveChild(
 XmlNode* oldChild
);
[JScript]
public function RemoveChild(
   oldChild : XmlNode
) : XmlNode;

Parameters

oldChild
The node being removed.

Return Value

The node removed.

Exceptions

Exception Type Condition
ArgumentException The oldChild is not a child of this node. Or this node is read-only.

Remarks

Notes to Inheritors:  When overriding RemoveChild in a derived class, in order for events to be fired correctly, you must call the RemoveChild method of the base class.

Example

[Visual Basic, C#, C++] The following example removes a node from the XML document.

[Visual Basic] 
Option Explicit
Option Strict

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>")
        
        Dim root As XmlNode = doc.DocumentElement
        
        'Remove the title element.
        root.RemoveChild(root.FirstChild)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub 'Main 
End Class 'Sample

[C#] 
using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Remove the title element.
    root.RemoveChild(root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
    XmlDocument* doc = new XmlDocument();
    doc->LoadXml(S"<book genre='novel' ISBN='1-861001-57-5'>" 
                 S"<title>Pride And Prejudice</title>" 
                 S"</book>");

    XmlNode* root = doc->DocumentElement;

    //Remove the title element.
    root->RemoveChild(root->FirstChild);

    Console::WriteLine(S"Display the modified XML...");
    doc->Save(Console::Out);
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

XmlNode Class | XmlNode Members | System.Xml Namespace

Show:
© 2014 Microsoft