Control.Controls 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.
ControlCollection Mendapatkan objek yang mewakili kontrol turunan untuk kontrol server tertentu dalam hierarki UI.
public:
virtual property System::Web::UI::ControlCollection ^ Controls { System::Web::UI::ControlCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.ControlCollection Controls { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Controls : System.Web.UI.ControlCollection
Public Overridable ReadOnly Property Controls As ControlCollection
Nilai Properti
Kumpulan kontrol anak untuk kontrol server yang ditentukan.
- Atribut
Contoh
Contoh berikut menunjukkan cara menambahkan kontrol anak ke objek kontrol ControlCollection server melalui propertinya Controls .
Controls.Add(new LiteralControl("<h3>Value: "));
Controls.Add(New LiteralControl("<h3>Value: "))
Keterangan
Pada halaman ASP.NET, ketika kontrol ditambahkan secara deklaratif antara tag pembuka dan penutupan kontrol server, ASP.NET secara otomatis menambahkan kontrol ke kontrol ControlCollectionserver yang berisi . Tag HTML atau string teks apa pun yang tidak diproses di server diperlakukan sebagai LiteralControl objek. Ini ditambahkan ke koleksi seperti kontrol server lainnya.
Properti Controls memungkinkan Anda akses terprogram ke instans ControlCollection kelas untuk kontrol server apa pun. Anda dapat menambahkan kontrol ke koleksi, menghapus kontrol dari koleksi, atau melakukan iterasi melalui kontrol server dalam koleksi.
Catatan Bagi Inheritor
Saat mengambil alih Controls properti, pastikan untuk memanggil EnsureChildControls() metode . Selain itu, jika Anda berencana untuk menambahkan kontrol ke koleksi kontrol secara terprogram, pertimbangkan untuk menambahkan kontrol dalam metode yang ditimpa CreateChildControls() .