<think>我们创建一个自定义服务器控件，该控件包含一个CheckBoxList和两个TextBox。 步骤： 1. 创建一个类库项目（Class Library）用于生成自定义控件的DLL。 2. 在类库项目中，创建一个继承自System.Web.UI.WebControls.CompositeControl的类。 3. 重写CreateChildControls方法，在该方法中实例化子控件（CheckBoxList和两个TextBox）并设置它们的属性。 4. 将这些子控件添加到当前控件的Controls集合中。 5. 为了能够在设计时看到效果，可以为控件添加一些设计时属性（如[ToolboxData]）。 6. 生成项目，将生成的DLL添加到Web项目的引用中，然后在工具箱中就可以使用该自定义控件。 注意：由于是自定义复合控件，我们需要确保在回发时能够保持状态（ViewState），复合控件通常会自动处理子控件的状态，但我们需要确保在每次请求时都重新创建子控件。 下面是一个简单的实现示例： 首先，在类库项目中，添加对System.Web的引用。 然后，创建自定义控件类，比如命名为CheckBoxListWithTextBoxes： 代码示例： </think> ### 创建包含 CheckBoxList 和两个 TextBox 的自定义服务器控件 以下是创建自定义控件的完整步骤（使用 C# 和 ASP.NET Web Forms）： #### 1. 创建自定义控件类 ```csharp using System.ComponentModel; using System.Web.UI; using System.Web.UI.WebControls; [DefaultProperty("Text")] [ToolboxData("<{0}:CheckBoxTextControl runat=server></{0}:CheckBoxTextControl>")] public class CheckBoxTextControl : CompositeControl { // 声明子控件 private CheckBoxList chkList; private TextBox textBox1; private TextBox textBox2; // 公开属性（可选） [Bindable(true)] [Category("Appearance")] [DefaultValue("")] public string TextBox1Value { get { EnsureChildControls(); return textBox1.Text; } set { EnsureChildControls(); textBox1.Text = value; } } [Bindable(true)] [Category("Appearance")] [DefaultValue("")] public string TextBox2Value { get { EnsureChildControls(); return textBox2.Text; } set { EnsureChildControls(); textBox2.Text = value; } } // 重写创建子控件方法 protected override void CreateChildControls() { Controls.Clear(); // 创建 CheckBoxList chkList = new CheckBoxList { ID = "chkOptions", RepeatDirection = RepeatDirection.Horizontal }; Controls.Add(chkList); // 创建第一个 TextBox textBox1 = new TextBox { ID = "txtInput1", CssClass = "custom-textbox" }; Controls.Add(textBox1); // 创建第二个 TextBox textBox2 = new TextBox { ID = "txtInput2", CssClass = "custom-textbox" }; Controls.Add(textBox2); } // 重写渲染方法 protected override void Render(HtmlTextWriter writer) { // 添加容器 DIV writer.AddAttribute(HtmlTextWriterAttribute.Class, "checkbox-text-container"); writer.RenderBeginTag(HtmlTextWriterTag.Div); // 渲染子控件 chkList.RenderControl(writer); writer.Write("<br />"); textBox1.RenderControl(writer); writer.Write("<br />"); textBox2.RenderControl(writer); writer.RenderEndTag(); // 关闭 DIV } } ``` #### 2. 在页面中使用自定义控件 ```aspx <%@ Register Assembly="YourAssemblyName" Namespace="YourNamespace" TagPrefix="custom" %> <custom:CheckBoxTextControl runat="server" ID="myCustomControl" TextBox1Value="默认值1" TextBox2Value="默认值2"/> ``` #### 3. 后端访问控件值 ```csharp // 获取文本框值 string value1 = myCustomControl.TextBox1Value; string value2 = myCustomControl.TextBox2Value; // 获取复选框选中项 List<string> selectedItems = new List<string>(); foreach (ListItem item in myCustomControl.FindControl("chkOptions") as CheckBoxList) { if (item.Selected) selectedItems.Add(item.Value); } ``` #### 关键实现说明： 1. **继承 `CompositeControl`**：自动管理子控件的视图状态和生命周期 2. **`CreateChildControls()`**：创建子控件实例并添加到控件树 3. **`EnsureChildControls()`**：在属性访问器中确保子控件已创建 4. **公开自定义属性**：通过属性封装内部控件的访问 5. **渲染控制**：使用 `Render()` 方法定制 HTML 输出结构 #### 可选增强功能： 1. 添加 `Items` 属性直接操作复选框项： ```csharp public ListItemCollection Items { get { EnsureChildControls(); return chkList.Items; } } ``` 2. 添加事件处理（如选项改变事件）： ```csharp public event EventHandler SelectionChanged; protected void OnCheckBoxChanged(object sender, EventArgs e) { SelectionChanged?.Invoke(this, e); } ``` 3. 添加设计时支持： ```csharp [Designer("System.Web.UI.Design.WebControls.CompositeControlDesigner")] [ParseChildren(true)] ``` ### 部署步骤 1. 将类编译为 DLL 并添加到 Web 项目的 Bin 目录 2. 在 Web.config 中注册控件： ```xml <system.web> <pages> <controls> <add tagPrefix="custom" namespace="YourNamespace" assembly="YourAssemblyName"/> </controls> </pages> </system.web> ``` 此实现满足以下需求： - 复合控件封装了 CheckBoxList 和两个 TextBox - 通过属性公开关键功能 - 保持视图状态和回发数据 - 支持设计时编辑 - 符合 ASP.NET 服务器控件生命周期[^1][^5]