Latest web development tutorials

ASP.NET ListItem 控件

Web Server Controls 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 Server Controls Web服務器控件