ASP.NET ListItem 控件


up.gif 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 HTMLText 属性Value 属性显示的文本使用的值
已设置已设置已设置Inner HTMLValue 属性
已设置已设置未设置Inner HTMLInner HTML
已设置未设置已设置Inner HTMLValue 属性
已设置未设置未设置Inner HTMLInner 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 控件。


up.gif Web 服务器控件