CheckBoxList控件

 

 

主要介绍：自定义数据、绑定数据库数据、全选，取消全选。

 

这种方法是绑定已经给定（自定义）的字段（这种方法是绑定给定的值，就是在编写控件时给Text赋的值）：

前台代码：

<asp:CheckBoxList ID="CheckBoxList1" runat="server">
    <asp:ListItem Text ="苹果"></asp:ListItem>
    <asp:ListItem Text ="柠檬"></asp:ListItem>
    <asp:ListItem Text ="橘子"></asp:ListItem>
    <asp:ListItem Text ="桃子"></asp:ListItem>
</asp:CheckBoxList>
<asp:Button ID="Button1" runat="server" Text="结果" OnClick ="Button1_Click"/>
<asp:Label ID="Label1" runat="server" Text=""></asp:Label>

 

后台代码：

/// <summary>
/// Button单击事件
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
protected void Button1_Click(object sender, EventArgs e)
{
    string s = string.Empty;

    for (int i = 0; i < this.CheckBoxList1.Items.Count; i++)
    {
        if (this.CheckBoxList1.Items[i].Selected)
        {
            s += this.CheckBoxList1.Items[i].Text + " ";
        }
    }
    this.Label1.Text = "你选择的水果有：" + s;
}

 

最终效果:

 

 

----------------------------------------------------------------

 

 

这种方法，是和数据库（SQL Server）中的数据进行绑定，也就是从数据库中取值显示：

 

一：

首先，先在数据库中建立一张表：

CREATE TABLE KK
(
    id INT,
    [name] VARCHAR(20),
)

然后插入数据：

INSERT INTO KK (id, [name]) VALUES (1, '张三')
INSERT INTO KK (id, [name]) VALUES (2, '李四')
INSERT INTO KK (id, [name]) VALUES (3, '王五')
INSERT INTO KK (id, [name]) VALUES (4, '赵六')

这是最终建立的表：

 

 

二：

然后是前台代码：

<asp:CheckBoxList ID="CheckBoxList1" runat="server" AutoPostBack ="true"></asp:CheckBoxList>
<asp:Button ID="Button1" runat="server" Text="结果" OnClick ="Button1_Click"/><br /><br />
<asp:Label ID="Label1" runat="server" Text=""></asp:Label>

*解说：CheckBoxList控件，如果要是在后台代码之中绑定数据，那么在前台代码做任何修改。

其中，AutoPostBack要为true才可。

 

后台代码：

web.config中数据库连接字符串：

  <connectionStrings>
    <add name="connectionString" connectionString="data source = (local); database = TEMP; integrated security = true"/>
  </connectionStrings>

 

后台之中Page_load中的代码（代码初始化，用于打开界面是就进行数据绑定）：

protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        /* 为什么判断IsPostBack:当你需要执行一些仅需要在页面第一次浏览时执行的事件
         * 比如页面初始化，数据绑定之类的操作时，需要将操作放在if(!IspostBack)里面，
         * 这样当你在点击页面中的按钮或者执行其他回发事件时，不贵再次初搜索始化或者
         * 重复绑定数据，提高了执行效率。
         */
        {
            string connectionString = ConfigurationManager.ConnectionStrings["connectionString"].ConnectionString;

            SqlConnection connection = new SqlConnection(connectionString);

            connection.Open();

            string sql = "SELECT * FROM KK";

            SqlCommand cmd = new SqlCommand(sql, connection);

            SqlDataReader sdr = cmd.ExecuteReader();

            //任意给的字段名，只要是想显示在界面上的就行。其值给了：Text
            this.CheckBoxList1.DataTextField = "name";

            //任意给得字段名，只要是想在后台看到前台看不到的数据就行。其值给了：Value
            this.CheckBoxList1.DataValueField = "id";

            this.CheckBoxList1.DataSource = sdr;

            this.CheckBoxList1.DataBind();

            sdr.Close();

            connection.Close();
        }
    }

 其中，检查网页是否会发很重要。if (!IsPostBack)。如果没有这个，将无法使用。

 

后台之中Button（结果）按钮：

/// <summary>
/// Button单击事件
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
protected void Button1_Click(object sender, EventArgs e)
{
    string s = string.Empty;

    for (int i = 0; i < CheckBoxList1.Items.Count; i++)
    {
        if (this.CheckBoxList1.Items[i].Selected)
        {
            s += "  界面上能看到的值（对应控上的Text属性）：  " 
                + this.CheckBoxList1.Items[i].Text.ToString() 

                + "<br/>界面上看不到的值，源程序中能看到（对应控件上的Value属性）：" 
                + this.CheckBoxList1.Items[i].Value.ToString() + "<br/><br/>";
        }
    }

    this.Label1.Text = s;
}

 

 

最终运行效果：

 

----------------------------------------------------------------

 

 

全选和取消全选：

首先要在前台中加一个CheckBox控件，用来控制是否全选：

<asp:CheckBoxList ID="CheckBoxList1" runat="server" AutoPostBack ="true"></asp:CheckBoxList><br /><br />

<asp:CheckBox ID ="checkbox1" runat ="server" Text ="全选" AutoPostBack ="true" OnCheckedChanged ="checkbox1_CheckedChanged1"/>

<asp:Button ID="Button1" runat="server" Text="结果" OnClick ="Button1_Click"/><br /><br />
<asp:Label ID="Label1" runat="server" Text=""></asp:Label>

*解说：下划线标注的代码就是添加的CheckBox控件，用来决定是否全选。其中OnCheckedChange事件决定当选择改变时执行什么代码。

其中，设置:AutoPostBack ="true" 很重要。

 

 

然后是后台代码（checkbox1_CheckedChanged1事件）：

/// <summary>
/// checkbox1_CheckedChanged1当选择改变时执行相应的代码
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
protected void checkbox1_CheckedChanged1(object sender, EventArgs e)
{
    if (this.checkbox1.Checked)
    {
        for (int j = 0; j < this.CheckBoxList1.Items.Count; j++)
        {
            this.CheckBoxList1.Items[j].Selected = true;//全部设置为选中
        }
    }
    else
    {
        for (int k = 0; k < this.CheckBoxList1.Items.Count; k++)
        {
            this.CheckBoxList1.Items[k].Selected = false;//全部设置为未选中
        }
    

 

最终执行效果：

 

选中：　　　　　　　　　　　　　　

         

 

 

未选中：

 

 

 

----------------------------------------------------------------

 

 

 

最后附上CheckBoxList控件的属性和事件列表（此内容摘自：http://www.cnblogs.com/huangqing/articles/2226353.html）：

CheckBoxList控件属性和事件
1、AutoPostBack属性：用于设置当单击checkboxList控件时，是否自动回送到服务器。True表示回送；False（默认）表示不回送。
2、DataSource属性：用于指定填充列表控件的数据源。
3、DataTextField属性：指定DataSource中一个字段，该字段的值对应于列表项的Text属性。
4、DataValueField属性：指定DataSource中一个字段，字段的值对应于列表项的Value属性。
5、Items属性：表示复选框列表中各个选项的集合，如CheckBoxList1.Items（i）表示第i个选项，i从0开始。每个选项都有以下3个基本属性：
Text属性：表示每个选项的文本。
Value属性：表示每个选项的选项值。
Selected属性：表示该选项是否被选中。
Count属性：通过Items.Count属性可获得CheckBoxList控件的选项数；
Add方法：通过items.Add方法可以向CheckBoxList控件添加选项；
Remove方法：通过items.Remove方法，可从CheckBoxList控件中删除指定的选项；
Insert方法：通过items.insert方法，可将一个新的选项插入到CheckBoxList控件中；
Clear方法：通过items.clear方法可以清空CheckBoxList控件中的选项。
6、RepeatColumns属性：用于指定在CheckBoxList控件中显示选项占用几列。默认值为0，表示任意多列。
7、RepeatDirection属性：用于指定CheckBoxList控件的显示方向。Vertical时，列表项以列优先排列的形式显示；Horizontal时，列项以行优先排列的形式显示。
8、RepeatLayout属性：用于设置选项的排列方式。Table（默认）时，以表结构显示，属性值为Flow时，不以表结构显示。
9、SelectedIndex属性：用于获取或设置列表中选定项的最低序号索引值。如果列表控件中只有一个选项被选中，则该属性表示当前选定项的索引值。
10、SelectedItem属性：用于获取列表控件中索引值最小的选定项。如果列表中只有一个选项被选中，则该属性表示当前选定项。通过该属性可获得选定项的Text和Value属性值。
11：SelectedIndexchanged事件：当用户选择了列表中的任意复选框时，都将引发事件。

 

以上就是CheckBoxList控件的用法。