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

Definition

Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten.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 ()

Beispiele

Im folgenden Beispiel wird eine überschriebene Version der CreateChildControls -Methode veranschaulicht.The following example demonstrates an overridden version of the CreateChildControls method. In dieser Implementierung zeigt das zusammengesetzte Steuerelement TextBox ein Steuerelement an, das in zwei Literalsteuerelemente eingeschlossen ist, die HTML darstellenIn this implementation, the composite control displays a TextBox control enclosed in two literal controls that render HTML.

Wichtig

Dieses Beispiel umfasst ein Textfeld, das Benutzereingaben akzeptiert, die ein potenzielles Sicherheitsrisiko darstellen.This example has a text box that accepts user input, which is a potential security threat. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.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

Hinweise

Wenn Sie ein zusammengesetztes oder Vorlagen Server-Steuerelement entwickeln, müssen Sie diese Methode überschreiben.When you develop a composite or templated server control, you must override this method. Steuerelemente, die CreateChildControls die-Methode über INamingContainer schreiben, sollten die-Schnittstelle implementieren, um NamenskonflikteControls that override the CreateChildControls method should implement the INamingContainer interface to avoid naming conflicts.

Weitere Informationen finden Sie unter Vorlagen für Webserver Steuerelemente und entwickeln von benutzerdefinierten ASP.NET-Server Steuerelementen.For more information, see Web Server Controls Templates and Developing Custom ASP.NET Server Controls.

Gilt für:

Siehe auch