ASP.NET ListItem 控件

定义和用法

ListItem 控件可创建列表中的一个项目。

此控件与这些列表控件一同使用：<asp:ListBox> 、<asp:RadioButtonList> 以及 <asp:BulletedList>。

语法

  1. <asp:ListItem
  2. Enabled="True|False"
  3. Selected="True|False"
  4. Text="label"
  5. Value="value" />

属性

属性 描述 .NET
Attributes 可选的。此类不直接支持的 ListItem 的属性名和值对的集合。 1.0
Enabled 可选的。规定是否禁用或启用项目。 2.0
Selected 可选的。规定是否选定该项。 1.0
Text 可选的。在 ListItem 中显示的文本。 1.0
Value 可选的。ListItem 的值。 1.0

ListControl 标准属性

  1. AppendDataBoundItems, AutoPostBack, CausesValidation, DataTextField,
  2. DataTextFormatString, DataValueField, Items, runat, SelectedIndex, SelectedItem,
  3. SelectedValue, TagKey, Text, ValidationGroup, OnSelectedIndexChanged

ListControl 控件包括列表控件的所有基本功能。继承自此控件的控件包括：CheckBoxList, DropDownList, ListBox 以及 RadioButtonList 控件。

如需完整描述，请访问 ListControl 标准属性。

Web 控件标准属性

  1. AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, 
  2. CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, 
  3. SkinID, Style, TabIndex, ToolTip, Width

如需完整描述，请访问 Web 控件标准属性。

控件标准属性

  1. AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, 
  2. EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, 
  3. TemplateControl, TemplateSourceDirectory, UniqueID, Visible

如需完整描述，请访问控件标准属性。

有可能使用 Text 或 Value 属性以及 inner HTML 文本来设置显示列表项的文本。

例子

  1. <asp:ListItem Value="Text1" Text="Text2">Text3</asp:ListItem>

根据 Text 或 Value 属性以及 inner HTML 文本的组合，可显示不同的文本，并可使用不同的值。下面的表格列出了所有可能的组合以及它们的值：

内部 HTML 内容 文本属性 值属性 呈现的“内部 HTML”内容 呈现的“值”属性
已设置 已设置 已设置 内部 HTML 内容 值属性
已设置 已设置 未设置 内部 HTML 内容 内部 HTML 内容
已设置 未设置 已设置 内部 HTML 内容 值属性
已设置 未设置 未设置 内部 HTML 内容 “内部 HTML”文本
未设置 已设置 已设置 文本属性 值属性
未设置 已设置 未设置 文本属性 文本属性
未设置 未设置 已设置 值属性 值属性
未设置 未设置 未设置 未设置 未设置

提示和注释

注释：由于 Text 和 Value 属性都具有空字符串默认值，所以列表控件中可能有空列表项。

实例

在 BulletedList 中的基本 ListItem

本例展示了 .aspx 文件中带有两个 ListItems 的 BulletedList 控件。 

  1. <html>
  2. <body>
  4. <form runat="server">
  5. <asp:BulletedList runat="server">
  6. <asp:ListItem Text="Item1" />
  7. <asp:ListItem Text="Item2" />
  8. </asp:BulletedList>
  9. </form>
  11. </body>
  12. </html>

ListBox 中带有不同属性的 ListItem

本例展示了 .aspx 文件中带有几个 ListItem 的 ListBox 控件。列表中的文本使用了不同的属性来显示列表项的文本。 

  1. <html>
  2. <body>
  4. <form runat="server">
  5. <asp:ListBox runat="server">
  6. <asp:ListItem Text="Text1" />
  7. <asp:ListItem Value="Text3" Text="Text1">Text2</asp:ListItem>
  8. <asp:ListItem Value="Text3" />
  9. </asp:ListBox>
  10. </form>
  12. </body>
  13. </html>

ListItem disabled in ListBox

本例展示了一个带有被禁用的列表项的 ListBox 控件。 

  1. <html>
  2. <body>
  4. <form runat="server">
  5. <asp:ListBox runat="server">
  6. <asp:ListItem Text="Item1" />
  7. <asp:ListItem Text="Item2" />
  8. <asp:ListItem Text="Item3" />
  9. <asp:ListItem Text="Item4" enabled="False"/>
  10. </asp:ListBox>
  11. </form>
  13. </body>
  14. </html>

ListItem selected in RadioButtonList

本例展示了一个带有已选列表项的 RadioButtonList 控件。 

  1. <html>
  2. <body>
  4. <form runat="server">
  5. <asp:RadioButtonList runat="server">
  6. <asp:ListItem Text="Item1" />
  7. <asp:ListItem Text="Item2" />
  8. <asp:ListItem Text="Item3" />
  9. <asp:ListItem Text="Item4" selected="True"/>
  10. </asp:RadioButtonList>
  11. </form>
  13. </body>
  14. </html>