定义和用法
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 控件。