Ler em inglês

Compartilhar via


Control.CreateChildControls Método

Definição

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.

C#
protected virtual void CreateChildControls();
C#
protected internal virtual void 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.

C#
// 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>"));
 }

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.

Aplica-se a

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também