XmlNode.PrependChild(XmlNode) メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.dll, System.Xml.XmlDocument.dll

アセンブリ:

System.Xml.ReaderWriter.dll

アセンブリ:

System.Xml.XmlDocument.dll

アセンブリ:

System.Xml.dll

アセンブリ:

netstandard.dll

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

public:
 virtual System::Xml::XmlNode ^ PrependChild(System::Xml::XmlNode ^ newChild);

public virtual System.Xml.XmlNode PrependChild (System.Xml.XmlNode newChild);

public virtual System.Xml.XmlNode? PrependChild (System.Xml.XmlNode newChild);

abstract member PrependChild : System.Xml.XmlNode -> System.Xml.XmlNode
override this.PrependChild : System.Xml.XmlNode -> System.Xml.XmlNode

Public Overridable Function PrependChild (newChild As XmlNode) As XmlNode

パラメーター

newChild

XmlNode

追加するノード。 追加するノードのすべての内容が、指定した場所に移動します。

戻り値

XmlNode

追加されたノード。

例外

InvalidOperationException

このノードは、newChild ノードの型の子ノードが許可されない型です。

newChild がこのノードの先祖です。

ArgumentException

newChild は、このノードを作成したドキュメントとは異なるドキュメントから作成されました。

このノードは読み取り専用です。

例

次の使用例は、XML ドキュメントに新しいノードを追加します。

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

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

Option Explicit
Option Strict

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
End Class

注釈

既に newChild ツリー内にある場合は、元の位置から削除され、ターゲットの位置に追加されます。 ノードの挿入の詳細については、「 XML ドキュメントへのノードの挿入」を参照してください。

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

このメソッドは、ドキュメント オブジェクト モデル (DOM) に対する Microsoft の拡張機能です。

注意 (継承者)

派生クラスでオーバーライドする PrependChild 場合、イベントを正しく発生させるには、基底クラスのメソッドを PrependChild 呼び出す必要があります。

こちらもご覧ください

• ImportNode(XmlNode, Boolean)
• XML ドキュメントへのノードの挿入