HtmlElement.InnerHtml Properti
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.
Mendapatkan atau mengatur markup HTML di bawah elemen ini.
public:
property System::String ^ InnerHtml { System::String ^ get(); void set(System::String ^ value); };
public string InnerHtml { get; set; }
member this.InnerHtml : string with get, set
Public Property InnerHtml As String
Nilai Properti
Markup HTML yang menentukan elemen turunan dari elemen saat ini.
Pengecualian
Membuat elemen turunan pada elemen ini tidak diperbolehkan.
Keterangan
Ada beberapa cara untuk menambahkan elemen baru ke halaman HTML yang sudah ada, seperti AppendChild metode dan InsertAdjacentElement . Menggunakan InnerHtml sering kali merupakan cara tercepat untuk menambahkan konten baru ketika Anda harus mengatur banyak atribut atau gaya pada elemen baru Anda.
InnerHtml berbeda dari OuterHtml dalam yang InnerHtml tidak akan menyertakan HTML yang mewakili objek yang Anda panggil. Lihat OuterHtml untuk informasi selengkapnya tentang perbedaan antara kedua properti ini.
Pengaturan InnerHtml menghancurkan setiap anak yang sebelumnya ditambahkan ke elemen . Jika Anda mengambil elemen dari DOM dan kemudian menetapkan HTML baru ke properti induknya InnerHtml , referensi Anda ke elemen tersebut tidak akan berguna, dan perilakunya ketika memanggil properti dan metodenya tidak ditentukan.
Untuk beberapa elemen, pengaturan InnerHtml bukan operasi yang valid. Beberapa tag HTML tidak memiliki tag penutup, seperti IMG tag, dan karenanya tidak dapat berisi elemen berlapis. Beberapa tag, seperti SCRIPT tag, hanya dapat berisi konten teks; pengaturan InnerHtml akan mengakibatkan kesalahan. Untuk kedua jenis tag, CanHaveChildren properti akan mengembalikan false. Namun, Anda juga tidak dapat mengatur InnerHtml elemen TABLE dan TR , karena menetapkan HTML cacat ke elemen-elemen ini dapat merusak penyajian dokumen. Gunakan AppendChild atau metode dan insertCell pada antarmuka yang tidak dikelola IHTMLTable untuk menambahkan baris dan sel ke TABLEinsertRow .
Jika Anda hanya perlu menetapkan teks ke elemen dan bukan markup HTML, gunakan properti sebagai gantinya InnerText .
Menetapkan nilai untuk InnerHtml akan menghancurkan nilai teks apa pun yang sebelumnya ditetapkan menggunakan InnerText.