Control.CreateChildControls Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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.
protected:
virtual void CreateChildControls();protected public:
virtual void CreateChildControls();protected virtual void CreateChildControls ();protected internal virtual void CreateChildControls ();abstract member CreateChildControls : unit -> unit
override this.CreateChildControls : unit -> unitProtected Overridable Sub CreateChildControls ()Protected Friend Overridable Sub CreateChildControls ()Ejemplos
En el ejemplo siguiente se muestra una versión invalidada del CreateChildControls método . En esta implementación, el control compuesto muestra un TextBox control incluido en dos controles literales que representan 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. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.
// 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
Comentarios
Al desarrollar un control de servidor compuesto o con plantilla, debe invalidar este método. Los controles que invalidan el CreateChildControls método deben implementar la INamingContainer interfaz para evitar conflictos de nomenclatura.
Para obtener más información, vea Plantillas de controles de servidor web y Desarrollo de controles de servidor personalizados de ASP.NET.
