ASP.NET中WebForm组件CheckBoxList编程

作者：马金虎  来自：yesky

CheckBox选择组件是一个程序中都经常的组件。在程序设计中使用到该组件，一般都不会只使用到一个，往往是以多个此类组件的形式出现的。在ASP.NET页面中如果要使用到多个CheckBox组件，除了添加多个CheckBox组件在页面中之外，还有一种比较方便的方法，就是使用CheckBoxList组件。CheckBoxList组件是由一组的CheckBox组件组成的，在此组件中CheckBox是做为条目的形式出现的，并且对每个在CheckBoxList组件中的CheckBox都有一个索引号，这样在程序中就更容易来处理了。

　　这时你可能要问，这不是多此一举么，既然有了CheckBox组件，还要CheckBoxList组件干什么？这是因为在程序设计的过程中，处理CheckBoxList组件要往往要比处理CheckBox组件相对容易的多并且也明了的多。举例如下：

　　假定有一个CheckBoxList组件和有十个CheckBox组件，并且这个CheckBoxList组件是由这十个CheckBox组件构成的。为了检测这十个CheckBox组件中的哪些已经被选择的，如果程序中选用的CheckBox组件就需要如下代码：

　if ( C1 . Checked )
　{
　　}
　if ( C2 . Checked )
　{
　　}
　....
　if ( C10 . Checked )
　{
　} 

　　但如果程序中使用了CheckBoxList组件，就只需要以下这几行代码就可以了：

　for ( int i = 0 ; i ＜ CHK . Items . Count ; i++ )
　{
　　if ( CHK . Items [ i ] . Selected )
　　{
　　　//处理你要完成的工作
　　}
　}

　　注释：其中C1 -- C10是CheckBox组件，CHK是CheckBoxList组件

　　可见用了CheckBoxList组件，在程序设计中的确更明了，更简洁了。并且只要你掌握了CheckBoxList组 件的用法，CheckBox组件的用法大致也就会了。

一． 如何在创建一个CheckBoxList组件：

＜asp:CheckBoxList runat = "server" id = C1 ＞
＜asp:ListItem Value = 1 ＞第一个检查框＜/asp:ListItem ＞
＜asp:ListItem Value = 2 ＞第二个检查框＜/asp:ListItem ＞
＜asp:ListItem Value = 3 ＞第三个检查框＜/asp:ListItem ＞
.....
注释：在这里可以加入若干个检查框
＜/asp:CheckBoxList ＞

　　在ASP.NET页面中加入上面的语句，就可以产生一个名称为"C1"的CheckBoxList组件了。

　　二． CheckBoxList组件中经常使用到的属性：

　　I ＞ .TextAlign属性：取值为：Left、Right。如果TextAlign的值为Left则CheckBoxList组件中的检查框的文字在选框的左边，同理如果TextAlign的值为Right则检查框的文字在选框的右边。

　　II ＞ .Selected属性：为布尔型，判定组件中的检查框是否被选中。

　　III ＞ .RepeatColumns属性：在CheckBoxList组件中有若干检查框，此属性主要是设定这些检查框到底用多少行来显示。

　　IV ＞ .RepeatDirection属性：此属性的值可为：Vertical、Horizontal。当设定了RepeatColumns属性后，设定此属性是如何排列组件中的各个检查框的。具体如下：

　　假定CheckBoxList组件有四个检查框，并且RepeatColumns属性值为2。

　　（1）.如果RepeatDirection ＝ Vertical，则在页面中检查框的显示方式如下：

　　　检查框01 检查框03

　　　检查框02 检查框04

　　（2）.如果RepeatDirection ＝ Horizontal，则在页面中检查框的显示方式如下：

　　　检查框01 检查框02

　　　检查框03 检查框04

　　V ＞ .Count属性：返回CheckBoxList组件中有多少检查框。

　　三． CheckBoxList组件中经常使用到的方法：

　　（1）.在组件中增加一个检查框，语法如下：

　　　CHKList . Items . Add ( new ListItem ( ＜ text ＞ , ＜ value ＞ ) )

　　（2）.访问组件中的检查框，语法如下：

　　　CHKList . Items [ ＜ index ＞ ]

　　（3）.删除组件中的检查框，语法如下：

　　　CHKList . Items . Remove ( ＜ index ＞ )

四． 实例介绍CheckBoxList组件的使用方法：

　　（1）.如何判定选择了组件中的哪些检查框：

　　在程序中，是通过处理Selected属性和Count属性来完成的，具体如下：

for ( int i = 0 ; i ＜ ChkList . Items . Count ; i++ )
{
if( ChkList . Items [ i ] . Selected )
{
lblResult . Text += ChkList . Items [ i ] .Text + " ＜br ＞ " ;
}
}

　　（2）.如何设定CheckBoxList组件的外观布局：

　　CheckBoxList组件有比较多的属性来设定它的外观，在本文介绍的程序中，主要是通过四个方面来设定组件的外观布局的：组件中的检查框中的文本和选框的排列位置、组件中各个检查框布局、组件中各个检查框排列方向和组件中各个检查框的排列行数，具体的程序代码如下：

//组件中的检查框中的文本和选框的排列位置
switch ( cboAlign . SelectedIndex )
{
　case 0 :
　　ChkList . TextAlign = TextAlign . Left ;
　　break ;
　case 1 :
　　ChkList . TextAlign = TextAlign . Right ;
　　break ;
} 
//组件中各个检查框布局
switch ( cboRepeatLayout . SelectedIndex )
{
　case 0 :
　　ChkList . RepeatLayout = RepeatLayout . Table ;
　　break ;
　case 1 :
　　ChkList . RepeatLayout = RepeatLayout . Flow ;
　　break ;
}

//组件中各个检查框排列方向
switch ( cboRepeatDirection . SelectedIndex)
{
　case 0 :
　　ChkList . RepeatDirection = RepeatDirection . Vertical ;
　　break ;
　case 1 :
　　ChkList . RepeatDirection = RepeatDirection . Horizontal ;
　　break ;
}

//组件中各个检查框的排列行数
try
{
　int cols = int . Parse ( txtRepeatCols.Text ) ;
　ChkList . RepeatColumns = cols ;
}
catch ( Exception )
{ 
}

五． 文中源程序代码(Check.aspx)和执行的界面：

　　下图是执行了下列源程序代码(Check.aspx)后，生成的界面：

　　Check.aspx源程序代码如下:

＜% @ Page Language = "C#" %＞

＜html ＞
＜head ＞
＜title ＞ CheckBoxList组件演示程序 ＜/title ＞
＜script runat = "server" ＞
　protected void Button_Click ( object sender , EventArgs e )
　{
　　//组件中的检查框中的文本和选框的排列位置
　　switch ( cboAlign . SelectedIndex )
　　{
　　　case 0 :
　　　　ChkList . TextAlign = TextAlign . Left ;
　　　　break ;
　　　case 1 :
　　　　ChkList . TextAlign = TextAlign . Right ;
　　　　break ;
　　}

　　//组件中各个检查框布局
　　switch ( cboRepeatLayout . SelectedIndex )
　　{
　　　case 0 :
　　　　ChkList . RepeatLayout = RepeatLayout . Table ;
　　　　break ;
　　　case 1 :
　　　　ChkList . RepeatLayout = RepeatLayout . Flow ;
　　　　break ;
　　}

　　//组件中各个检查框排列方向
　　switch ( cboRepeatDirection . SelectedIndex)
　　{
　　　case 0 :
　　　　ChkList . RepeatDirection = RepeatDirection . Vertical ;
　　　　break ;
　　　case 1 :
　　　　ChkList . RepeatDirection = RepeatDirection . Horizontal ;
　　　　break ;
　　}

　　//组件中各个检查框的排列行数
　　try
　　{
　　　int cols = int . Parse ( txtRepeatCols.Text ) ;
　　　ChkList . RepeatColumns = cols ;
　　}
　　catch ( Exception )
　　{ 
　　}

　　lblResult . Text = "" ;
　　for ( int i = 0 ; i ＜ ChkList . Items . Count ; i++ )
　　{
　　　if( ChkList . Items [ i ] . Selected )
　　　{
　　　　lblResult . Text += ChkList . Items [ i ] .Text + " ＜br ＞ " ;
　　　}
　　}
　}
　＜/script ＞
　＜/head ＞
　＜body ＞
　＜form runat = "server" ＞
　　＜h1 align = center ＞ CheckBoxList组件演示程序 ＜/h1 ＞
　　＜table ＞
　　　＜tr ＞
　　　　＜td ＞ 组件中的文本排列位置： ＜/td ＞
　　　　＜td ＞
　　　　　　＜asp:DropDownList id = cboAlign runat = "server" ＞
　　　　　　　＜asp:ListItem ＞ 居左 ＜/asp:ListItem ＞
　　　　　　　＜asp:ListItem ＞ 居右 ＜/asp:ListItem ＞
　　　　　　＜/asp:DropDownList ＞
　　　　＜/td ＞
　　　＜/tr ＞
　　　＜tr ＞
　　　　＜td ＞ 组件中各个条目布局： ＜/td ＞
　　　　＜td ＞
　　　　　　＜asp:DropDownList id = cboRepeatLayout runat = "server" ＞
　　　　　　　＜asp:ListItem ＞ 表格型 ＜/asp:ListItem ＞
　　　　　　　＜asp:ListItem ＞ 紧凑型 ＜/asp:ListItem ＞
　　　　　　＜/asp:DropDownList ＞
　　　　＜/td ＞
　　　＜/tr ＞
　　　＜tr ＞
　　　　＜td＞ 组件中各个条目排列方向：＜/td ＞
　　　　＜td ＞
　　　　　　＜asp:DropDownList id = cboRepeatDirection runat = "server" ＞
　　　　　　　＜asp:ListItem ＞ 水平方向 ＜/asp:ListItem ＞
　　　　　　　＜asp:ListItem ＞ 垂直方向 ＜/asp:ListItem ＞
　　　　　　＜/asp:DropDownList ＞
　　　　＜/td ＞
　　　＜/tr ＞
　　　＜tr ＞
　　　　＜td ＞ 组件中各个条目排列行数： ＜/td ＞
　　　　＜td ＞ ＜asp:TextBox id = "txtRepeatCols" runat = "server" /＞ ＜/td ＞ 
　　　＜/tr ＞
　　＜/table ＞
　　＜br ＞
　　　请选择你所需要学习的计算机语言类型：
　　＜br ＞
　　＜asp:CheckBoxList id = "ChkList" RepeatDirection = Horizontal runat = "server" ＞
　　　＜asp:ListItem ＞ Visual C++ .Net ＜/asp:ListItem ＞
　　　＜asp:ListItem ＞ Visual C# ＜/asp:ListItem ＞
　　　＜asp:ListItem ＞ VB.NET ＜/asp:ListItem ＞
　　　＜asp:ListItem ＞ JScript.NET ＜/asp:ListItem ＞
　　　＜asp:ListItem ＞ Visual J# ＜/asp:ListItem ＞
　　＜/asp:CheckBoxList ＞
　　＜br ＞
　　　＜asp:Button Text = "提交" runat = "server" onclick = "Button_Click" /＞
　　　＜h1 ＞ ＜font color = red ＞ 你选择的计算机语言类型为： ＜/font ＞ ＜/h1 ＞
　　　＜asp:Label id = lblResult runat = "server" /＞
　＜/form ＞
　＜/body ＞
＜/html ＞

　　六． 总结：

　　其实CheckBoxList组件也是一个服务器端组件。本文介绍了CheckBoxList组件中的一些主要的属性和方法，并且通过一个比较典型的例子说明了在ASP.NET页面中如何进行与CheckBoxList组件相关的编程，其实对于另外一个比较重要的组件--CheckBox来说，他们中有许多的相似之处，掌握了CheckBoxList组件的用法大致也就掌握了CheckBox组件的用法。