XmlNode.PrependChild(XmlNode) メソッド

定義

名前空間:

System.Xml

アセンブリ:

netstandard.dll, System.Xml.ReaderWriter.dll

ソース:

XmlNode.cs

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

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;
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 ドキュメントへのノードの挿入