XmlDocument.InsertBefore(IXmlNode, IXmlNode) Metode

Definisi

Menyisipkan simpul anak ke sebelah kiri simpul yang ditentukan, atau di akhir daftar simpul anak.

public:
 virtual IXmlNode ^ InsertBefore(IXmlNode ^ newChild, IXmlNode ^ referenceChild) = InsertBefore;
IXmlNode InsertBefore(IXmlNode const& newChild, IXmlNode const& referenceChild);
public IXmlNode InsertBefore(IXmlNode newChild, IXmlNode referenceChild);
function insertBefore(newChild, referenceChild)
Public Function InsertBefore (newChild As IXmlNode, referenceChild As IXmlNode) As IXmlNode

Parameter

newChild
IXmlNode

Alamat simpul baru yang akan disisipkan. Simpul yang diteruskan di sini harus merupakan anak yang valid dari simpul dokumen XML DOM saat ini. Misalnya, jika simpul saat ini adalah atribut , Anda tidak dapat meneruskan atribut lain dalam parameter newChild , karena atribut tidak dapat memiliki atribut sebagai anak. Jika newChild adalah jenis node DOCUMENT_FRAGMENT, semua turunannya disisipkan secara berurutan sebelum referenceChild.

Jika newChild sudah ada di pohon, pertama-tama dihapus sebelum dimasukkan ulang sebelum node referenceChild . Simpul baca-saja, seperti simpul NODE_DOCUMENT_TYPE dan NODE_ENTITY, tidak dapat diteruskan dalam parameter newChild .

referenceChild
IXmlNode

Simpul referensi. Simpul yang ditentukan adalah tempat simpul newChild akan disisipkan ke kiri sebagai saudara kandung sebelumnya dalam daftar anak. Simpul yang diteruskan di sini harus merupakan simpul anak dari simpul saat ini atau null. Jika nilainya null, simpul newChild disisipkan di akhir daftar anak. Jika node referenceChild bukan anak dari simpul saat ini, kesalahan akan dikembalikan.

Mengembalikan

Jika berhasil, simpul anak yang dimasukkan. Jika null, tidak ada objek yang dibuat.

Penerapan

Berlaku untuk