ASP.NET ListItem 控件

定义和用法

ListItem 控件可创建列表中的一个项目。

此控件与以下列表控件一同使用：<asp:ListBox>、 <asp:RadioButtonList> 和 <asp:BulletedList>。

语法

<asp:ListItem
 Enabled="True|False"
 Selected="True|False"
 Text="label"
 Value="value" />

属性

属性	描述	.NET
Attributes	可选的。此类不直接支持的 ListItem 的属性名和值对的集合。	1.0
Enabled	可选的。规定是否禁用或启用项目。	2.0
Selected	可选的。规定是否选定该项。	1.0
Text	可选的。在 ListItem 中显示的文本。	1.0
Value	可选的。ListItem 的值。	1.0

Web 控件标准属性

AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width

控件标准属性

AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible

有可能使用 Text 或 Value 属性以及 inner HTML 文本来设置显示列表项的文本。

实例

<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

<!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

<!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

<!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

<!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 控件。