XmlNode.InsertBefore(XmlNode, XmlNode) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

System.Xml.ReaderWriter.dll

Sumber:

XmlNode.cs

Menyisipkan simpul yang ditentukan segera sebelum simpul referensi yang ditentukan.

public:
 virtual System::Xml::XmlNode ^ InsertBefore(System::Xml::XmlNode ^ newChild, System::Xml::XmlNode ^ refChild);

public virtual System.Xml.XmlNode? InsertBefore (System.Xml.XmlNode newChild, System.Xml.XmlNode? refChild);

abstract member InsertBefore : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
override this.InsertBefore : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode

Public Overridable Function InsertBefore (newChild As XmlNode, refChild As XmlNode) As XmlNode

Parameter

newChild

XmlNode

Simpul yang akan disisipkan.

refChild

XmlNode

Simpul referensi. newChild ditempatkan sebelum simpul ini.

Mengembalikan

XmlNode

Simpul sedang disisipkan.

Pengecualian

InvalidOperationException

Simpul saat ini adalah jenis yang tidak mengizinkan simpul anak dari jenis simpul newChild .

newChild adalah leluhur dari simpul ini.

ArgumentException

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

refChild bukan anak dari simpul ini.

Simpul ini bersifat baca-saja.

Contoh

Contoh berikut menambahkan simpul baru ke dokumen 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->InsertBefore( elem, root->FirstChild );
   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.InsertBefore(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

Option Strict
Option Explicit

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

Keterangan

Jika refChild adalah null, sisipkan newChild di akhir daftar simpul anak. Semua konten newChild disisipkan, dalam urutan yang sama, sebelum refChild. 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 sedang disisipkan dibuat dari dokumen lain, Anda bisa menggunakan XmlDocument.ImportNode untuk mengimpor simpul ke dokumen saat ini. Simpul yang diimpor kemudian dapat disisipkan ke dalam dokumen saat ini.

Catatan Bagi Inheritor

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

Lihat juga

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