Control.CreateChildControls Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывается платформой страницы 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 -> unitProtected 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.
