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