使用英语阅读

通过


Control.CreateChildControls 方法

定义

由 ASP.NET 页框架调用,以通知服务器控件在准备回发或呈现时使用基于撰写的实现来创建其所包含任何子控件。

C#
protected virtual void CreateChildControls();
C#
protected internal virtual void CreateChildControls();

示例

以下示例演示 方法的 CreateChildControls 重写版本。 在此实现中,复合控件显示一个包含在两个 TextBox 文本控件中的控件,用于呈现 HTML。

重要

此示例具有一个接受用户输入的文本框,这是一个潜在的安全威胁。 默认情况下,ASP.NET 网页验证用户输入是否不包含脚本或 HTML 元素。 有关详细信息,请参阅脚本侵入概述

C#
// 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>"));
 }

注解

开发复合或模板化服务器控件时,必须重写此方法。 替代 方法的 CreateChildControls 控件应实现 接口, INamingContainer 以避免命名冲突。

有关详细信息,请参阅 Web 服务器控件模板开发自定义 ASP.NET 服务器控件

适用于

产品 版本
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另请参阅