Control.CreateChildControls Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização.

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 ()

Exemplos

O exemplo a seguir demonstra uma versão substituída do CreateChildControls método . Nessa implementação, o controle composto exibe um TextBox controle entre dois controles literais que renderizam HTML.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

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

Comentários

Ao desenvolver um controle de servidor composto ou modelo, você deve substituir esse método. Os controles que substituem o CreateChildControls método devem implementar a INamingContainer interface para evitar conflitos de nomenclatura.

Para obter mais informações, consulte Modelos de controles de servidor Web e Desenvolvendo controles de servidor de ASP.NET personalizados.

Confira também

• Controls
• ControlCollection
• ChildControlsCreated
• INamingContainer
• Desenvolvendo controles de servidores ASP.NET personalizados
• ASP.NET modelos de controles de servidor Web