ASP.NET ListItem 控件
定义和用法
ListItem 控件可创建列表中的一个项目。
此控件与以下列表控件一同使用:<asp:ListBox>、 <asp:RadioButtonList> 和 <asp:BulletedList>。
语法
1 | <div><asp:ListItem<br> Enabled= "True|False" <br> Selected= "True|False" <br> Text= "label" <br> Value= "value" /></div>
|
属性
属性 |
描述 |
.NET |
Attributes |
可选的。此类不直接支持的 ListItem 的属性名和值对的集合。 |
1.0 |
Enabled |
可选的。规定是否禁用或启用项目。 |
2.0 |
Selected |
可选的。规定是否选定该项。 |
1.0 |
Text |
可选的。在 ListItem 中显示的文本。 |
1.0 |
Value |
可选的。ListItem 的值。 |
1.0 |
Web 控件标准属性
1 | AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width
|
控件标准属性
1 | AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible
|
有可能使用 Text 或 Value 属性以及 inner HTML 文本来设置显示列表项的文本。
实例
1 | <asp:ListItem Value= "Text1" Text= "Text2" >Text3</asp:ListItem>
|
根据 Text 或 Value 属性以及 inner HTML 文本的组合,可显示不同的文本,并可使用不同的值。下面的表格列出了所有可能的组合以及它们的结果:
Inner HTML |
Text 属性 |
Value 属性 |
显示的文本 |
使用的值 |
已设置 |
已设置 |
已设置 |
Inner HTML |
Value 属性 |
已设置 |
已设置 |
未设置 |
Inner HTML |
Inner HTML |
已设置 |
未设置 |
已设置 |
Inner HTML |
Value 属性 |
已设置 |
未设置 |
未设置 |
Inner HTML |
Inner HTML |
未设置 |
已设置 |
已设置 |
Text 属性 |
Value 属性 |
未设置 |
已设置 |
未设置 |
Text 属性 |
Text 属性 |
未设置 |
未设置 |
已设置 |
Value 属性 |
Value 属性 |
未设置 |
未设置 |
未设置 |
未设置 |
未设置 |
提示和注释
注释:由于 Text 和 Value 属性都具有空字符串默认值,所以列表控件中可能有空列表项。
实例
带有基本 ListItem 的 BulletedList
1 2 3 4 5 6 7 8 9 10 11 12 13 | <!DOCTYPE html>
<html>
<body>
<form runat= "server" >
<asp:BulletedList runat= "server" >
<asp:ListItem Text= "Item1" />
<asp:ListItem Text= "Item2" />
</asp:BulletedList>
</form>
</body>
</html>
|
本例展示了 .aspx 文件中带有两个 ListItem 的 BulletedList 控件。
带有不同属性的 ListItem 的 ListBox
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | <!DOCTYPE html>
<html>
<body>
<form runat= "server" >
<asp:ListBox runat= "server" >
<asp:ListItem Text= "Text1" />
<asp:ListItem Value= "Text3" Text= "Text1" >Text2</asp:ListItem>
<asp:ListItem Value= "Text3" />
</asp:ListBox>
</form>
</body>
</html>
|
本例展示了 .aspx 文件中带有几个 ListItem 的 ListBox 控件。列表中的项目使用了不同的属性来显示 ListItem 的文本。
带有被禁用的 ListItem 的 ListBox
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <!DOCTYPE html>
<html>
<body>
<form runat= "server" >
<asp:ListBox runat= "server" >
<asp:ListItem Text= "Item1" />
<asp:ListItem Text= "Item2" />
<asp:ListItem Text= "Item3" />
<asp:ListItem Text= "Item4" enabled= "False" />
</asp:ListBox>
</form>
</body>
</html>
|
本例展示了一个带有被禁用的 ListItem 的 ListBox 控件。
带有已选的 ListItem 的 RadioButtonList
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <!DOCTYPE html>
<html>
<body>
<form runat= "server" >
<asp:RadioButtonList runat= "server" >
<asp:ListItem Text= "Item1" />
<asp:ListItem Text= "Item2" />
<asp:ListItem Text= "Item3" />
<asp:ListItem Text= "Item4" selected= "True" />
</asp:RadioButtonList>
</form>
</body>
</html>
|
本例展示了一个带有已选 ListItem 的 RadioButtonList 控件。