XmlNode.InsertAfter メソッドとは何？わかりやすく解説 Weblio辞書

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

public virtual XmlNode InsertAfter (
    XmlNode newChild,
    XmlNode refChild
)

C++

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

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 がこのノードの子ではありません。このノードは読み取り専用です。

例外の種類

条件

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

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 );
}

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