ListItem Web 控件并不是一个独立存在的控件,它必须依附在下列几种Web 控件下;例如RadioButtonList Web 控件、DropDownList Web 控件以及CheckBoxList 控件。一个ListItem Web控件代表的是一个ListControl Web 控件的选项内容,也因为如此所以可以不需要指定Id 属性。其使用语法如下:
<ASP:ItemList
Id="被程序代码所控制的名称"
Runat="Server"
Selected="True | False"
Text="标示项目的文字"
Value="相关资料"
/>
或
<ASP:ItemList
Id="被程序代码所控制的名称"
Runat="Server"
Selected="True | False"
Value="相关资料"
>
标示项目的文字
</ASP:ItemList>
下表列出ListItem Web 控件常用的属性说明:
其使用的方式如下所示:
<ASP:ListItem>Item1</ASP:ListItem >
或
<ASP:ListItem Text="Item1" />
当我们使用程序来产生一个ListItem Web 控件的实体时,其建构方式有三种:
1. Dim liA As New ListItem
2. Dim liA As New ListItem("Item1")
3. Dim liA As New ListItem("Item1","Item Value")
第二种方式在建构实体时,一并设定其Text 属性;第三种方式则是设定其Text 属性及Value 属性。Value 属性和Text 属性的型态一样都是字符串,但是Text 属性的内容会显示出来而Value不会。当我们在页面上显示的内容和实际要做运算的数据不同时,就可以利这个属性。下列范例利用RadioButtonList Web 控件以及ListItem Web 控件让使用者选择性别,并且指定其相关的Value 属性为M 及F,如下范例所示:
<Html>
<Form Id="Form1" Runat="Server">
<ASP:RadioButtonList Id="rblA" Runat="Server">
<ASP:ListItem Text="男" Selected="True" Value="M"/>
<ASP:ListItem Text="女" Value="F"/>
</ASP:RadioButtonList>
<ASP:Button Id="B1" Runat="Server" Text='确定' OnClick="B1_Click"/>
</Form>
<ASP:Label Id="Label1" Runat="Server"/>
<Script Language="VB" Runat="Server">
Sub B1_Click(Sender As Object,e As Eventargs)
Label1.Text="您选择了" & rblA.SelectedItem.Text & " , 它的相关值为"
& _
rblA.SelectedItem.Value
End Sub
</Script>
</Html>
上列程序代码范例中,只要直接参考RadioButtonList Web 控件的SelectedItem 属性,就可以取得被选取到的ListItem 对象。RadioButtonList Web 控件内的项目也可以用程序来动态的新增,我们只要先产生一个ListItem 型态的对象变量,再用RadioButtonList Web 控件Items 集合的Add 方法将这个对象加到Items 集合内即可。下列程序代码范例动态的增加六个ListItem,并排列成两栏:
<Html>
<Form Id="Form1" Runat="Server">
<ASP:RadioButtonList Id="rblA" RepeatColumns="2" Runat="Server" />
</Form>
<Script Language="VB" Runat="Server">
Sub Page_Load(Sender As Object, e As Eventargs)
Dim shtI As Short
For shtI=1 To 6
Dim liA As New ListItem
liA.Text="这是第" & shtI.ToString & " 个项目"
rblA.Items.Add(liA)
Next
End Sub
</Script>
</Html>