Control.CreateChildControls Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки.

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

Примеры

В следующем примере показана переопределенная версия CreateChildControls метода. В этой реализации составной элемент управления отображает элемент управления, заключенный TextBox в два литеральных элемента управления, отрисовывающих HTML.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

// 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 метод, должны реализовывать INamingContainer интерфейс, чтобы избежать конфликтов именования.

Дополнительные сведения см. в разделе "Шаблоны веб-серверных элементов управления" и "Разработка пользовательских ASP.NET серверных элементов управления".

См. также раздел

• Controls
• ControlCollection
• ChildControlsCreated
• INamingContainer
• Разработка пользовательских ASP.NET серверных элементов управления
• Шаблоны элементов управления веб-серверами ASP.NET