Membuat Referensi Entitas Baru

Metode CreateEntityReference membuat simpul XmlEntityReference baru. Model Objek Dokumen XML (DOM) melihat apakah nama entitas yang direferensikan telah dideklarasikan. Jika sudah demikian, simpul anak dari simpul XmlEntityReference disalin dari simpul deklarasi entitas. Jika tidak ada deklarasi entitas yang cocok, simpul teks kosong dilampirkan sebagai satu-satunya anak dari simpul referensi entitas. Karena simpul anak dari simpul XmlEntityReference adalah salinan simpul lain, simpul anak ini bersifat baca-saja dan tidak dapat dimodifikasi.

Ketika simpul disalin, mungkin ada namespace dalam cakupan di titik referensi entitas. Namespace ini memengaruhi konfigurasi node elemen atau atribut apa pun yang dihasilkan.

Nota

DOM menambahkan simpul anak ke EntityReference hanya saat Anda menyisipkan simpul EntityReference ke dokumen. Simpul EntityReference yang baru dibuat tidak memiliki node anak.

Meskipun XmlDataDocument adalah kelas turunan dari XmlDocument, XmlDataDocument tidak mendukung pembuatan referensi entitas. Ini karena anak EntityReference bersifat baca-saja. Anak-anak simpul EntityReference dapat menjangkau lebih dari satu wilayah. Dalam hal ini, bagian dari baris yang terkait dengan wilayah yang berisi bagian dari EntityReference akan bersifat baca-saja.

Lihat juga

• Model Objek Dokumen XML (DOM)