Control.CreateChildControls Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Appelée par l’infrastructure de page ASP.NET pour signaler aux contrôles serveur qu’ils doivent utiliser l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en vue de la publication ou du rendu.

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

Exemples

L’exemple suivant illustre une version remplacée de la CreateChildControls méthode. Dans cette implémentation, le contrôle composite affiche un TextBox contrôle placé dans deux contrôles littéral qui affichent du code HTML.

Important

Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques 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

Remarques

Lorsque vous développez un contrôle serveur composite ou modèle, vous devez remplacer cette méthode. Les contrôles qui remplacent la CreateChildControls méthode doivent implémenter l’interface INamingContainer pour éviter les conflits de noms.

Pour plus d’informations, consultez Modèles de contrôles de serveur web et Développement de contrôles serveur ASP.NET personnalisés.

Voir aussi

• Controls
• ControlCollection
• ChildControlsCreated
• INamingContainer
• Développement de contrôles serveur ASP.NET personnalisés
• modèles de contrôles de serveur web ASP.NET