XmlNode.PrependChild メソッド

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

XmlNode.PrependChild メソッド

このノードの子ノードのリストの先頭に、指定したノードを追加します。

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

Visual Basic (宣言)

Public Overridable Function
 PrependChild ( _
    newChild As XmlNode _
) As XmlNode

Visual Basic (使用法)

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

returnValue = instance.PrependChild(newChild)

C#

public virtual XmlNode PrependChild (
    XmlNode newChild
)

C++

public:
virtual XmlNode^ PrependChild (
    XmlNode^ newChild
)

J#

public XmlNode PrependChild (
    XmlNode newChild
)

JScript

public function PrependChild (
    newChild : XmlNode
) : XmlNode

パラメータ

newChild

追加するノード。そのノードが XmlDocumentFragment の場合は、ドキュメント フラグメントの内容全体がこのノードの子リストに移動されます。

戻り値
追加されたノード。

例外

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

解説

newChild が既にツリーに存在する場合は、最初に削除されます。

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

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

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

使用例

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

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
        
        'Create a new node.
        Dim elem As XmlElement = doc.CreateElement("price")
        elem.InnerText = "19.95"
        
        'Add the node to the document.
        root.PrependChild(elem)
        
        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.PrependChild(elem);

    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->PrependChild( elem );
   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.PrependChild(elem);

        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