Control.EnsureChildControls 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.
Menentukan apakah kontrol server memuat kontrol turunan. Jika tidak, ia membuat kontrol anak.
protected:
virtual void EnsureChildControls();protected virtual void EnsureChildControls ();abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unitProtected Overridable Sub EnsureChildControls ()Contoh
Contoh berikut menggunakan EnsureChildControls metode untuk memastikan bahwa kontrol server saat ini memiliki kontrol turunan. Kemudian mendapatkan atau mengatur Text properti untuk kontrol Web anak TextBox di objek kontrol ControlCollection server saat ini.
Penting
Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.
// Ensure the current control has children,
// then get or set the Text property.
public int Value {
get {
this.EnsureChildControls();
return Int32.Parse(((TextBox)Controls[1]).Text);
}
set {
this.EnsureChildControls();
((TextBox)Controls[1]).Text = value.ToString();
}
}
' Ensure the current control has children,
' then get or set the Text property.
Public Property Value() As Integer
Get
Me.EnsureChildControls()
Return Int32.Parse(CType(Controls(1), TextBox).Text)
End Get
Set
Me.EnsureChildControls()
CType(Controls(1), TextBox).Text = value.ToString()
End Set
End Property
Keterangan
Metode ini pertama-tama memeriksa nilai ChildControlsCreated properti saat ini. Jika nilai ini adalah false, CreateChildControls metode dipanggil.
Metode EnsureChildControls ini biasanya digunakan dalam kontrol komposit, yang merupakan kontrol yang menggunakan kontrol anak untuk beberapa atau semua fungsionalitasnya. Metode EnsureChildControls ini dipanggil untuk memastikan bahwa kontrol anak telah dibuat dan siap untuk memproses input, untuk melakukan pengikatan data, atau untuk melakukan tugas lain.
Kontrol GridView adalah contoh kontrol komposit. Ini membuat kontrol anak seperti Tablekontrol , , TableRowTableCell, Label, dan TextBox , yang digunakan untuk merender tabel HTML yang GridView dihasilkan.
Dalam kebanyakan kasus, pengembang kontrol server kustom tidak perlu mengambil alih metode ini. Jika Anda mengambil alih metode ini, gunakan dengan cara yang mirip dengan perilaku default.
