XmlNode.InsertBefore(XmlNode, XmlNode) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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);
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
Simpul sedang disisipkan.
Pengecualian
Simpul saat ini adalah jenis yang tidak mengizinkan simpul anak dari jenis simpul newChild
.
newChild
adalah leluhur dari simpul ini.
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.