ASP.NET ListItem 控件
定義和用法
ListItem 控件可創(chuàng)建列表中的一個項目。
此控件與這些列表控件一同使用：<asp:ListBox> 、<asp:RadioButtonList> 以及 <asp:BulletedList>。
語法
<asp:ListItem Enabled="True|False" Selected="True|False" Text="label" Value="value" />
屬性
| 屬性 | 描述 | .NET |
|---|---|---|
| Attributes | 可選的。此類不直接支持的 ListItem 的屬性名和值對的集合。 | 1.0 |
| Enabled | 可選的。規(guī)定是否禁用或啟用項目。 | 2.0 |
| Selected | 可選的。規(guī)定是否選定該項。 | 1.0 |
| Text | 可選的。在 ListItem 中顯示的文本。 | 1.0 |
| Value | 可選的。ListItem 的值。 | 1.0 |
ListControl 標準屬性
AppendDataBoundItems, AutoPostBack, CausesValidation, DataTextField, DataTextFormatString, DataValueField, Items, runat, SelectedIndex, SelectedItem, SelectedValue, TagKey, Text, ValidationGroup, OnSelectedIndexChanged
ListControl 控件包括列表控件的所有基本功能。繼承自此控件的控件包括：CheckBoxList, DropDownList, ListBox 以及 RadioButtonList 控件。
如需完整描述，請訪問 ListControl 標準屬性。
Web 控件標準屬性
AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width
如需完整描述，請訪問 Web 控件標準屬性。
控件標準屬性
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>
根據(jù) Text 或 Value 屬性以及 inner HTML 文本的組合，可顯示不同的文本，并可使用不同的值。下面的表格列出了所有可能的組合以及它們的值：
| 內(nèi)部 HTML 內(nèi)容 | 文本屬性 | 值屬性 | 呈現(xiàn)的“內(nèi)部 HTML”內(nèi)容 | 呈現(xiàn)的“值”屬性 |
|---|---|---|---|---|
| 已設置 | 已設置 | 已設置 | 內(nèi)部 HTML 內(nèi)容 | 值屬性 |
| 已設置 | 已設置 | 未設置 | 內(nèi)部 HTML 內(nèi)容 | 內(nèi)部 HTML 內(nèi)容 |
| 已設置 | 未設置 | 已設置 | 內(nèi)部 HTML 內(nèi)容 | 值屬性 |
| 已設置 | 未設置 | 未設置 | 內(nèi)部 HTML 內(nèi)容 | “內(nèi)部 HTML”文本 |
| 未設置 | 已設置 | 已設置 | 文本屬性 | 值屬性 |
| 未設置 | 已設置 | 未設置 | 文本屬性 | 文本屬性 |
| 未設置 | 未設置 | 已設置 | 值屬性 | 值屬性 |
| 未設置 | 未設置 | 未設置 | 未設置 | 未設置 |
提示和注釋
注釋：由于 Text 和 Value 屬性都具有空字符串默認值，所以列表控件中可能有空列表項。
實例
- 在 BulletedList 中的基本 ListItem
- 本例展示了 .aspx 文件中帶有兩個 ListItems 的 BulletedList 控件。
- ListBox 中帶有不同屬性的 ListItem
- 本例展示了 .aspx 文件中帶有幾個 ListItem 的 ListBox 控件。列表中的文本使用了不同的屬性來顯示列表項的文本。
- ListItem disabled in ListBox
- 本例展示了一個帶有被禁用的列表項的 ListBox 控件。
- ListItem selected in RadioButtonList
- 本例展示了一個帶有已選列表項的 RadioButtonList 控件。