ASP.NET CheckBoxList控件

叁歲伎倆 2021-06-26 16:06 473阅读 0赞

## 定义和用法 ##

`CheckBoxList` 控件用于创建多选的复选框组。

每个 `CheckBoxList` 控件中的可选项都是由 `ListItem` 元素定义的！

**提示：该控件支持数据绑定！**

## 属性 ##

<table> 
 <thead> 
  <tr> 
   <th align="left">属性</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left"><code>CellPadding</code></td> 
   <td align="left">表格单元格的边框与内容之间的像素数。</td> 
  </tr> 
  <tr> 
   <td align="left"><code>CellSpacing</code></td> 
   <td align="left">表格单元格之间的像素数。</td> 
  </tr> 
  <tr> 
   <td align="left"><code>RepeatColumns</code></td> 
   <td align="left">当显示复选框组时所用的列数。</td> 
  </tr> 
  <tr> 
   <td align="left"><code>RepeatDirection</code></td> 
   <td align="left">规定复选框组水平重复还是垂直重复。</td> 
  </tr> 
  <tr> 
   <td align="left"><code>RepeatLayout</code></td> 
   <td align="left">复选框组的布局。</td> 
  </tr> 
  <tr> 
   <td align="left"><code>runat</code></td> 
   <td align="left">规定该控件是服务器控件。必须设置为 “server”。</td> 
  </tr> 
  <tr> 
   <td align="left"><code>TextAlign</code></td> 
   <td align="left">文本出现在复选框的那一侧。</td> 
  </tr> 
 </tbody> 
</table>

## `ListControl` 标准属性 ##

> AppendDataBoundItems, AutoPostBack, CausesValidation, DataTextField, DataTextFormatString, DataValueField, Items, runat, SelectedIndex,SelectedItem, SelectedValue, TagKey, Text, ValidationGroup, OnSelectedIndexChanged

`ListControl` 控件包括列表控件的所有基本功能。继承自此控件的控件包括：`CheckBoxList`, `DropDownList`, `ListBox` 以及 `RadioButtonList` 控件。

## Web控件标准属性 ##

> AccessKey, Attributes, BackColor, BorderColor, BorderStyle,BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width

## 控件标准属性 ##

> AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible

## 实例 ##

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="TEST.aspx.cs" Inherits="Pro.TEST" %>
    
    <!DOCTYPE html>
    
    <html xmlns="http://www.w3.org/1999/xhtml">
    <head runat="server">
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        <title></title>
        <script runat="server"> public void Check(Object sender, EventArgs e) { int i = 0; mess.Text = "<p>Selected Item(s):</p>"; for (i = 0; i < check1.Items.Count; i++) { if (check1.Items[i].Selected) { mess.Text += check1.Items[i].Text + "<br />"; } } } </script>
    </head>
    <body>
        <form runat="server">
            <asp:CheckBoxList ID="check1" AutoPostBack="True" TextAlign="Right" OnSelectedIndexChanged="Check" runat="server">
                <asp:ListItem>Item 1</asp:ListItem>
                <asp:ListItem>Item 2</asp:ListItem>
                <asp:ListItem>Item 3</asp:ListItem>
                <asp:ListItem>Item 4</asp:ListItem>
                <asp:ListItem>Item 5</asp:ListItem>
                <asp:ListItem>Item 6</asp:ListItem>
            </asp:CheckBoxList>
            <br />
            <asp:Label ID="mess" runat="server" />
        </form>
    
    </body>
    </html>

![在这里插入图片描述][2019053021470487.png]  
在本例中，我们在 `.aspx` 文件中声明了一个 `CheckBoxList` 控件。然后我们为 `SelectedIndexChanged` 事件创建了一个事件句柄。这个可选列表包含六个复选框。当用户选中其中之一，页面会自动传回服务器，并执行 `Check` 子例程。该子例程会遍历控件的 `Items` 集合，并测试每个项目的 `Selected` 属性。被选的项目会显示在 `Label` 控件中。

[2019053021470487.png]: /images/20210626/30110f6b662d45ed83ffb8bf16b0d2b1.png