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 |
| 可选的。规定是否禁用或启用项目。 | 2.0 | |
| 可选的。规定是否选定该项。 | 1.0 | |
| 可选的。在 ListItem 中显示的文本。 | 1.0 | |
| 可选的。ListItem 的值。 | 1.0 |
ListControl 标准属性
AppendDataBoundItems, AutoPostBack, CausesValidation, DataTextField, DataTextFormatString, DataValueField, Items, runat, SelectedIndex, SelectedItem, SelectedValue, TagKey, Text, ValidationGroup, OnSelectedIndexChanged
ListControl 控件包括列表控件的所有基本功能。继承自此控件的控件包括：CheckBoxList, DropDownList, ListBox 以及 RadioButtonList 控件。
如需完整描述，请访问 。
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 文本的组合，可显示不同的文本，并可使用不同的值。下面的表格列出了所有可能的组合以及它们的值：
| 内部 HTML 内容 | 文本属性 | 值属性 | 呈现的“内部 HTML”内容 | 呈现的“值”属性 |
|---|---|---|---|---|
| 已设置 | 已设置 | 已设置 | 内部 HTML 内容 | 值属性 |
| 已设置 | 已设置 | 未设置 | 内部 HTML 内容 | 内部 HTML 内容 |
| 已设置 | 未设置 | 已设置 | 内部 HTML 内容 | 值属性 |
| 已设置 | 未设置 | 未设置 | 内部 HTML 内容 | “内部 HTML”文本 |
| 未设置 | 已设置 | 已设置 | 文本属性 | 值属性 |
| 未设置 | 已设置 | 未设置 | 文本属性 | 文本属性 |
| 未设置 | 未设置 | 已设置 | 值属性 | 值属性 |
| 未设置 | 未设置 | 未设置 | 未设置 | 未设置 |
提示和注释
注释：由于 Text 和 Value 属性都具有空字符串默认值，所以列表控件中可能有空列表项。
实例
- 本例展示了 .aspx 文件中带有两个 ListItems 的 BulletedList 控件。
- 本例展示了 .aspx 文件中带有几个 ListItem 的 ListBox 控件。列表中的文本使用了不同的属性来显示列表项的文本。
- 本例展示了一个带有被禁用的列表项的 ListBox 控件。
- 本例展示了一个带有已选列表项的 RadioButtonList 控件。