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:
 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 -> unit

Protected Overridable Sub CreateChildControls ()

Protected Friend Overridable Sub CreateChildControls ()

Exemples

L’exemple suivant illustre une version substituée de la CreateChildControls méthode. Dans cette implémentation, le contrôle composite affiche un TextBox contrôle placé entre deux contrôles littéraux 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 d’affectation 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