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源程序代码如下:
<% @ 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组件的用法。