[.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 ﹥ 
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 ﹥