This documentation is archived and is not being maintained.

XmlNode.InsertAfter Method

Inserts the specified node immediately after the specified reference node.

[Visual Basic]
Public Overridable Function InsertAfter( _
   ByVal newChild As XmlNode, _
   ByVal refChild As XmlNode _
) As XmlNode
public virtual XmlNode InsertAfter(
 XmlNode newChild,
 XmlNode refChild
public: virtual XmlNode* InsertAfter(
 XmlNode* newChild,
 XmlNode* refChild
public function InsertAfter(
   newChild : XmlNode,
 refChild : XmlNode
) : XmlNode;


The XmlNode to insert.
The XmlNode that is the reference node. The newNode is placed after the refNode.

Return Value

The node being inserted.


Exception Type 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.

The refChild is not a child of this node.

This node is read-only.


If refChild is a null reference (Nothing in Visual Basic), insert newChild at the beginning of the list of child nodes. If newChild is an XmlDocumentFragment object, its child nodes are inserted, in the same order, after refChild. 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).

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


[Visual Basic, C#, C++] The following example adds a new node to the XML document.

[Visual Basic] 
Option Strict
Option Explicit

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>" & _
        Dim root As XmlNode = doc.DocumentElement
        'Create a new node.
        Dim elem As XmlElement = doc.CreateElement("price")
        elem.InnerText = "19.95"
        'Add the node to the document.
        root.InsertAfter(elem, root.FirstChild)
        Console.WriteLine("Display the modified XML...")
    End Sub 'Main 
End Class 'Sample

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>" +

    XmlNode root = doc.DocumentElement;

    //Create a new node.
    XmlElement elem = doc.CreateElement("price");

    //Add the node to the document.
    root.InsertAfter(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");


#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>" 

    XmlNode* root = doc->DocumentElement;

    //Create a new node.
    XmlElement* elem = doc->CreateElement(S"price");

    //Add the node to the document.
    root->InsertAfter(elem, root->FirstChild);

    Console::WriteLine(S"Display the modified XML...");

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


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 | XmlDocument.ImportNode