ASP.NET ListItem 控制項
## Web 伺服器控制項
定義與用法
##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
如需完整描述，請存取 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 伺服器控制項
