XmlNode.InsertBefore メソッド

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

XmlNode.InsertBefore メソッド

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

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

Visual Basic (宣言)

Public Overridable Function
 InsertBefore ( _
    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.InsertBefore(newChild, refChild)

C#

public virtual XmlNode InsertBefore (
    XmlNode newChild,
    XmlNode refChild
)

C++

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

J#

public XmlNode InsertBefore (
    XmlNode newChild, 
    XmlNode refChild
)

JScript

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

パラメータ

newChild

挿入する XmlNode。

refChild

参照ノードである XmlNode。newChild は、このノードの前に配置されます。

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

例外

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

解説

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

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

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

使用例

新しいノードを 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.InsertBefore(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.InsertBefore(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->InsertBefore( 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.InsertBefore(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