Control.CreateChildControls Control.CreateChildControls Control.CreateChildControls Control.CreateChildControls Method

Definición

Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

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

Ejemplos

En el ejemplo siguiente se muestra una versión reemplazada de la CreateChildControls método.The following example demonstrates an overridden version of the CreateChildControls method. En esta implementación, se muestra el control compuesto de un TextBox control incluido en dos controles literales que se representan en HTML.In this implementation, the composite control displays a TextBox control enclosed in two literal controls that render HTML.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.For more information, see Script Exploits Overview.

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

Comentarios

Al desarrollar un control de servidor compuesto o con plantilla, debe invalidar este método.When you develop a composite or templated server control, you must override this method. Controla que la invalidación de la CreateChildControls método debe implementar la INamingContainer interfaz para evitar conflictos de nomenclatura.Controls that override the CreateChildControls method should implement the INamingContainer interface to avoid naming conflicts.

Para obtener más información, consulte plantillas de controles de servidor Web y desarrollar controles de servidor ASP.NET personalizados.For more information, see Web Server Controls Templates and Developing Custom ASP.NET Server Controls.

Se aplica a

Consulte también: