XmlNode.InsertAfter メソッド

.NET Framework クラス ライブラリ リファレンス

XmlNode.InsertAfter メソッド

指定したノードを指定した参照ノードの直後に挿入します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 InsertAfter ( _
    newChild As XmlNode, _
    refChild As XmlNode _
) As XmlNode

Visual Basic (使用法)

Dim instance As XmlNode
Dim newChild As XmlNode
Dim refChild As XmlNode
Dim returnValue As XmlNode

returnValue = instance.InsertAfter(newChild, refChild)

C#

public virtual XmlNode InsertAfter (
    XmlNode newChild,
    XmlNode refChild
)

C++

public:
virtual XmlNode^ InsertAfter (
    XmlNode^ newChild, 
    XmlNode^ refChild
)

J#

public XmlNode InsertAfter (
    XmlNode newChild, 
    XmlNode refChild
)

JScript

public function InsertAfter (
    newChild : XmlNode, 
    refChild : XmlNode
) : XmlNode

パラメータ

newChild

挿入する XmlNode。

refChild

参照ノードである XmlNode。newNode は、refNode の後に配置されます。

戻り値
挿入されるノード。

例外

例外の種類	条件
InvalidOperationException	このノードは、newChild ノードの型の子ノードが許可されない型です。 newChild がこのノードの先祖です。
ArgumentException	newChild は、このノードを作成したドキュメントとは異なるドキュメントから作成されました。 refChild がこのノードの子ではありません。 このノードは読み取り専用です。

解説

refChild が null 参照 (Visual Basic では Nothing) の場合は、子ノードのリストの先頭に newChild を挿入します。newChild が XmlDocumentFragment オブジェクトの場合は、その子ノードが同じ順序で refChild の後に挿入されます。newChild が既にツリーに存在する場合は、最初に削除されます。

別のドキュメントで作成されたノードを挿入する場合は、XmlDocument.ImportNode を使用してそのノードを現在のドキュメントにインポートできます。インポートされたノードは次に、現在のドキュメントに挿入できます。

このメソッドは、DOM (Document Object Model) に対する Microsoft 拡張機能です。

継承時の注意 派生クラスで InsertAfter をオーバーライドする場合は、イベントを正常に発生させるために、基本クラスの InsertAfter メソッドを呼び出す必要があります。

使用例

新しいノードを XML ドキュメントに追加する例を次に示します。

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>"
 & _
                    "</book>")
        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...")
        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;

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

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

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

  }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'>"
   "<title>Pride And Prejudice</title>"
   "</book>" );
   XmlNode^ root = doc->DocumentElement;
   
   //Create a new node.
   XmlElement^ elem = doc->CreateElement( "price" );
   elem->InnerText = "19.95";
   
   //Add the node to the document.
   root->InsertAfter( elem, root->FirstChild );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}

J#

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>"
            + "<title>Pride And Prejudice</title>"
            + "</book>");

        XmlNode root = doc.get_DocumentElement();

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

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

        Console.WriteLine("Display the modified XML...");
        doc.Save(Console.get_Out());
    } //main 
} //Sample

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlNode クラス
XmlNode メンバ
System.Xml 名前空間
XmlDocument.ImportNode