Control.EnsureChildControls Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.dll

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 -> unit

Protected 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.

Lihat juga

• Controls
• ChildControlsCreated
• CreateChildControls()