XmlDocument.InsertBefore(IXmlNode, IXmlNode) 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 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.