Control.CreateChildControls Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.dll

Dipanggil oleh kerangka kerja halaman ASP.NET untuk memberi tahu kontrol server yang menggunakan implementasi berbasis komposisi untuk membuat kontrol anak apa pun yang dikandungnya sebagai persiapan untuk memposting kembali atau merender.

protected public:
 virtual void CreateChildControls();

protected internal virtual void CreateChildControls ();

abstract member CreateChildControls : unit -> unit
override this.CreateChildControls : unit -> unit

Protected Friend Overridable Sub CreateChildControls ()

Contoh

Contoh berikut menunjukkan versi metode yang CreateChildControls ditimpa. Dalam implementasi ini, kontrol komposit menampilkan kontrol yang TextBox diapit dalam dua kontrol literal yang merender HTML.

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.

// Override CreateChildControls to create the control tree.
 [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="Execution")]
 protected override void CreateChildControls() {

     // Add a LiteralControl to the current ControlCollection.
     this.Controls.Add(new LiteralControl("<h3>Value: "));

     // Create a text box control, set the default Text property, 
     // and add it to the ControlCollection.
     TextBox box = new TextBox();
     box.Text = "0";
     this.Controls.Add(box);

     this.Controls.Add(new LiteralControl("</h3>"));
 }

' Override CreateChildControls to create the control tree.
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="Execution")> _
Protected Overrides Sub CreateChildControls()
   
   ' Add a LiteralControl to the current ControlCollection.
   Me.Controls.Add(New LiteralControl("<h3>Value: "))
   
   
   ' Create a text box control, set the default Text property, 
   ' and add it to the ControlCollection.
   Dim box As New TextBox()
   box.Text = "0"
   Me.Controls.Add(box)
   
   Me.Controls.Add(New LiteralControl("</h3>"))
End Sub

Keterangan

Ketika Anda mengembangkan kontrol server komposit atau templat, Anda harus mengambil alih metode ini. Kontrol yang mengambil alih CreateChildControls metode harus mengimplementasikan INamingContainer antarmuka untuk menghindari konflik penamaan.

Untuk informasi selengkapnya, lihat Templat Kontrol Server Web dan Mengembangkan Kontrol Server ASP.NET Kustom.

Lihat juga

• Controls
• ControlCollection
• ChildControlsCreated
• INamingContainer
• Mengembangkan Kontrol Server ASP.NET Kustom
• Templat Kontrol Server Web ASP.NET