ASP.NET中CheckBoxList复选框列表控件详细使用方法

ASP.NET中CheckBoxList复选框列表控件详细使用方法攻略

介绍

CheckBoxList（复选框列表）控件是ASP.NET中常用的控件之一，它可以以列表形式方便地提供多选功能，通常用于需要用户选择多个选项的场景。本攻略将详细介绍该控件的使用方法和示例。

控件特点

• 类似于RadioButtonList控件，可以轻松管理一组单选按钮，CheckBoxList是管理一组复选框的快捷方式。
• CheckBoxList中的每个复选框都与单个列表项相关联。
• 控件内置可个性化定制，可设置选项的文本和值、选择项的最大数量，以及在列表中显示的列数和行数。

控件属性

以下是一些常用的CheckBoxList控件属性:

• DataTextField：用于在每个列表项中显示文本值的字段的名称。
• DataValueField：用于在每个列表项中使用值属性存储的字段的名称。
• RepeatColumns：规定在列表中显示多少列。
• RepeatDirection：规定是水平（从左到右）还是垂直（从上到下）显示列表项。
• RepeatLayout：规定列表项是作为表格（Table）还是列表（Ul）显示。
• SelectedIndex：规定默认选中的列表项序号。
• SelectedValue：规定默认选中的列表项的值。

控件实例

下面是控件的一个简单实例。

示例一：创建控件

创建一个简单的CheckBoxList控件，包含三个选项：猫、狗和鼠标。

<asp:CheckBoxList ID="cb1" runat="server" RepeatColumns="1" RepeatDirection="Vertical"> 
    <asp:ListItem Text="猫" Value="1" />
    <asp:ListItem Text="狗" Value="2" /> 
    <asp:ListItem Text="鼠标" Value="3" />
</asp:CheckBoxList>

示例二：动态设置控件

在这个示例中，我们将从数据库中检索数据，将获取到的数据填充到CheckBoxList中。

<asp:CheckBoxList ID="cb2" runat="server" RepeatColumns="1" RepeatDirection="Vertical">
</asp:CheckBoxList>

protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        FillCheckBoxList();
    }
}

private void FillCheckBoxList()
{
    string connectionString = "Data Source=(localdb)\\MSSQLLocalDB;Initial Catalog=TestDB;Integrated Security=True;";
    using (SqlConnection conn = new SqlConnection(connectionString))
    {
        SqlCommand cmd = new SqlCommand();
        cmd.CommandType = CommandType.Text;
        cmd.CommandText = "SELECT Id, Name FROM Animals";
        cmd.Connection = conn;
        conn.Open();
        SqlDataReader reader = cmd.ExecuteReader();
        while (reader.Read())
        {
            ListItem li = new ListItem(reader["Name"].ToString(), reader["Id"].ToString());
            cb2.Items.Add(li);
        }
        reader.Close();
        conn.Close();
    }
}

在这个示例中，我们先创建一个空的CheckBoxList控件，然后使用FillCheckBoxList方法从数据库中检索数据，并将获取到的数据添加到CheckBoxList中。注意，在添加列表项时，我们先在数据库中选择了Id和Name这两个字段，然后在添加列表项时分别使用了这两个字段。

总结

CheckBoxList是一个功能强大的控件，可以很好地管理多个复选框。使用该控件前，需要先了解其常用属性和方法。在了解控件之后，我们可以使用它来创建动态的多选列表框，或者创建一个固定的多选列表框。