[.NET]CheckBoxList 用法

ASP.NET 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组件中有多少检查框。

三． ASP.NET CheckBoxList组件编程中经常使用到的方法：

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

1. CHKList . Items . Add ( new ListItem ( ﹤ text ﹥ , ﹤ value ﹥ ) ) 

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

1. CHKList . Items [ ﹤ index ﹥ ] 

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

1. CHKList . Items . Remove ( ﹤ index ﹥ ) 

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

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

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

1. for ( int i = 0 ; i ﹤ ChkList . Items . Count ; i++ )  
2. {  
3. if( ChkList . Items [ i ] . Selected )  
4. {  
5. lblResult . Text += ChkList . Items [ i ] .Text + "  " ;  
6. }  
7. } 

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

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

组件中各个检查框排列方向和组件中各个检查框的排列行数，具体的程序代码如下：

1. //组件中的检查框中的文本和选框的排列位置  
2. switch ( cboAlign . SelectedIndex )  
3. {  
4. 　case 0 :  
5. ChkList . TextAlign = TextAlign . Left ;  
6. break ;  
7. 　case 1 :  
8. ChkList . TextAlign = TextAlign . Right ;  
9. break ;  
10. }  
11. //组件中各个检查框布局  
12. switch ( cboRepeatLayout . SelectedIndex )  
13. {  
14. 　case 0 :  
15. ChkList . RepeatLayout = RepeatLayout . Table ;  
16. break ;  
17. 　case 1 :  
18. ChkList . RepeatLayout = RepeatLayout . Flow ;  
19. break ;  
20. }  
21. //组件中各个检查框排列方向  
22. switch ( cboRepeatDirection . SelectedIndex)  
23. {  
24. 　case 0 :  
25. ChkList . RepeatDirection = RepeatDirection . Vertical ;  
26. break ;  
27. 　case 1 :  
28. ChkList . RepeatDirection = RepeatDirection . Horizontal ;  
29. break ;  
30. }  
31. //组件中各个检查框的排列行数  
32. try 
33. {  
34. 　int cols = int . Parse ( txtRepeatCols.Text ) ;  
35. 　ChkList . RepeatColumns = cols ;  
36. }  
37. catch ( Exception )  
38. {  
39. } 

五． 文中源程序代码(Check.aspx)：

Check.aspx源程序代码如下:

1. ﹤% @ Page Language = "C#" %﹥  
2. ﹤html ﹥  
3. ﹤head ﹥  
4. ﹤title ﹥ CheckBoxList组件演示程序 ﹤/title ﹥  
5. ﹤script runat = "server" ﹥  
6. 　protected void Button_Click ( object sender , EventArgs e )  
7. 　{  
8. //组件中的检查框中的文本和选框的排列位置  
9. switch ( cboAlign . SelectedIndex )  
10. {  
11. 　case 0 :  
12. ChkList . TextAlign = TextAlign . Left ;  
13. break ;  
14. 　case 1 :  
15. ChkList . TextAlign = TextAlign . Right ;  
16. break ;  
17. }  
18. //组件中各个检查框布局  
19. switch ( cboRepeatLayout . SelectedIndex )  
20. {  
21. 　case 0 :  
22. ChkList . RepeatLayout = RepeatLayout . Table ;  
23. break ;  
24. 　case 1 :  
25. ChkList . RepeatLayout = RepeatLayout . Flow ;  
26. break ;  
27. }  
28. //组件中各个检查框排列方向  
29. switch ( cboRepeatDirection . SelectedIndex)  
30. {  
31. 　case 0 :  
32. ChkList . RepeatDirection = RepeatDirection . Vertical ;  
33. break ;  
34. 　case 1 :  
35. ChkList . RepeatDirection = RepeatDirection . Horizontal ;  
36. break ;  
37. }  
38. //组件中各个检查框的排列行数  
39. try 
40. {  
41. 　int cols = int . Parse ( txtRepeatCols.Text ) ;  
42. 　ChkList . RepeatColumns = cols ;  
43. }  
44. catch ( Exception )  
45. {  
46. }  
47. lblResult . Text = "" ;  
48. for ( int i = 0 ; i ﹤ ChkList . Items . Count ; i++ )  
49. {  
50. 　if( ChkList . Items [ i ] . Selected )  
51. 　{  
52. lblResult . Text += ChkList . Items [ i ] .Text + "  " ;  
53. 　}  
54. }  
55. 　}  
56. 　﹤/script ﹥  
57. 　﹤/head ﹥  
58. 　﹤body ﹥  
59. 　﹤form runat = "server" ﹥  
60. ﹤h1 align = center ﹥ CheckBoxList组件演示程序 ﹤/h1 ﹥  
61. ﹤table ﹥  
62. 　﹤tr ﹥  
63. ﹤td ﹥ 组件中的文本排列位置： ﹤/td ﹥  
64. ﹤td ﹥  
65. ﹤asp:DropDownList id = cboAlign runat = "server" ﹥  
66. 　﹤asp:ListItem ﹥ 居左 ﹤/asp:ListItem ﹥  
67. 　﹤asp:ListItem ﹥ 居右 ﹤/asp:ListItem ﹥  
68. ﹤/asp:DropDownList ﹥  
69. ﹤/td ﹥  
70. 　﹤/tr ﹥  
71. 　﹤tr ﹥  
72. ﹤td ﹥ 组件中各个条目布局： ﹤/td ﹥  
73. ﹤td ﹥  
74. ﹤asp:DropDownList id = cboRepeatLayout runat = "server" ﹥  
75. 　﹤asp:ListItem ﹥ 表格型 ﹤/asp:ListItem ﹥  
76. 　﹤asp:ListItem ﹥ 紧凑型 ﹤/asp:ListItem ﹥  
77. ﹤/asp:DropDownList ﹥  
78. ﹤/td ﹥  
79. 　﹤/tr ﹥  
80. 　﹤tr ﹥  
81. ﹤td﹥ 组件中各个条目排列方向：﹤/td ﹥  
82. ﹤td ﹥  
83. ﹤asp:DropDownList id = cboRepeatDirection runat = "server" ﹥  
84. 　﹤asp:ListItem ﹥ 水平方向 ﹤/asp:ListItem ﹥  
85. 　﹤asp:ListItem ﹥ 垂直方向 ﹤/asp:ListItem ﹥  
86. ﹤/asp:DropDownList ﹥  
87. ﹤/td ﹥  
88. 　﹤/tr ﹥  
89. 　﹤tr ﹥  
90. ﹤td ﹥ 组件中各个条目排列行数： ﹤/td ﹥  
91. ﹤td ﹥ ﹤asp:TextBox id = "txtRepeatCols" runat = "server" /﹥ ﹤/td ﹥  
92. 　﹤/tr ﹥  
93. ﹤/table ﹥ 

请选择你所需要学习的计算机语言类型：

1. ﹤asp:CheckBoxList id = "ChkList" RepeatDirection = Horizontal runat = "server" ﹥  
2. 　﹤asp:ListItem ﹥ Visual C++ .Net ﹤/asp:ListItem ﹥  
3. 　﹤asp:ListItem ﹥ Visual C# ﹤/asp:ListItem ﹥  
4. 　﹤asp:ListItem ﹥ VB.NET ﹤/asp:ListItem ﹥  
5. 　﹤asp:ListItem ﹥ JScript.NET ﹤/asp:ListItem ﹥  
6. 　﹤asp:ListItem ﹥ Visual J# ﹤/asp:ListItem ﹥  
7. ﹤/asp:CheckBoxList ﹥  
8.  
9. 　﹤asp:Button Text = "提交" runat = "server" onclick = "Button_Click" /﹥  
10. 　﹤h1 ﹥ ﹤font color = red ﹥ 你选择的计算机语言类型为： ﹤/font ﹥ ﹤/h1 ﹥  
11. 　﹤asp:Label id = lblResult runat = "server" /﹥  
12. 　﹤/form ﹥  
13. 　﹤/body ﹥  
14. ﹤/html ﹥