ASP.NET ListItem 控件
Web 伺服器控件
定義和用法
ListItem 控件可創建列表中的一個專案。
此控件與以下列表控件一同使用：<asp:ListBox>、 <asp:RadioButtonList> 和 <asp:BulletedList>。
語法
<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="label"
Value="value" />
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
如需完整描述，請訪問 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>
根據 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
本例展示了 .aspx 檔中帶有兩個 ListItem 的 BulletedList 控件。
帶有不同屬性的 ListItem 的 ListBox
本例展示了 .aspx 檔中帶有幾個 ListItem 的 ListBox 控件。列表中的專案使用了不同的屬性來顯示 ListItem 的文本。
帶有被禁用的 ListItem 的 ListBox
本例展示了一個帶有被禁用的 ListItem 的 ListBox 控件。
帶有已選的 ListItem 的 RadioButtonList
本例展示了一個帶有已選 ListItem 的 RadioButtonList 控件。
Web 伺服器控件