XmlNode.PrependChild(XmlNode) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlNode.cs

Menambahkan simpul yang ditentukan ke awal daftar simpul anak untuk simpul ini.

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

Parameter

newChild

XmlNode

Simpul yang akan ditambahkan. Semua konten simpul yang akan ditambahkan dipindahkan ke lokasi yang ditentukan.

Mengembalikan

XmlNode

Node ditambahkan.

Pengecualian

InvalidOperationException

Simpul ini berjenis yang tidak mengizinkan simpul anak dari jenis newChild simpul.

newChild adalah leluhur dari simpul ini.

ArgumentException

newChild Dibuat dari dokumen yang berbeda dari yang membuat simpul ini.

Simpul ini bersifat baca-saja.

Contoh

Contoh berikut menambahkan simpul baru ke dokumen 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

Keterangan

newChild Jika sudah ada di pohon, itu dihapus dari posisi aslinya dan ditambahkan ke posisi targetnya. Untuk informasi selengkapnya tentang menyisipkan simpul, lihat Menyisipkan Simpul ke dalam Dokumen XML.

Jika simpul yang disisipkan dibuat dari dokumen lain, Anda bisa menggunakan XmlDocument.ImportNode untuk mengimpor simpul ke dokumen saat ini. Simpul yang diimpor kemudian dapat dimasukkan ke dalam dokumen saat ini.

Metode ini adalah ekstensi Microsoft ke Model Objek Dokumen (DOM).

Catatan Bagi Inheritor

Saat mengambil alih di kelas turunan PrependChild , agar peristiwa dinaikkan dengan benar, Anda harus memanggil PrependChild metode kelas dasar.

Lihat juga

• ImportNode(XmlNode, Boolean)
• Menyisipkan Simpul ke dalam Dokumen XML