©
本文档使用 PHP中文网手册 发布
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 |
AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width
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
<!DOCTYPE html> <html> <body> <form runat="server"> <asp:BulletedList runat="server"> <asp:ListItem Text="Item1" /> <asp:ListItem Text="Item2" /> </asp:BulletedList> </form> </body> </html>
本例展示了 .aspx 文件中带有两个 ListItem 的 BulletedList 控件。
带有不同属性的 ListItem 的 ListBox
<!DOCTYPE html> <html> <body> <form runat="server"> <asp:ListBox runat="server"> <asp:ListItem Text="Text1" /> <asp:ListItem Value="Text3" Text="Text1">Text2</asp:ListItem> <asp:ListItem Value="Text3" /> </asp:ListBox> </form> </body> </html>
本例展示了 .aspx 文件中带有几个 ListItem 的 ListBox 控件。列表中的项目使用了不同的属性来显示 ListItem 的文本。
带有被禁用的 ListItem 的 ListBox
<!DOCTYPE html> <html> <body> <form runat="server"> <asp:ListBox runat="server"> <asp:ListItem Text="Item1" /> <asp:ListItem Text="Item2" /> <asp:ListItem Text="Item3" /> <asp:ListItem Text="Item4" enabled="False"/> </asp:ListBox> </form> </body> </html>
本例展示了一个带有被禁用的 ListItem 的 ListBox 控件。
带有已选的 ListItem 的 RadioButtonList
<!DOCTYPE html> <html> <body> <form runat="server"> <asp:RadioButtonList runat="server"> <asp:ListItem Text="Item1" /> <asp:ListItem Text="Item2" /> <asp:ListItem Text="Item3" /> <asp:ListItem Text="Item4" selected="True"/> </asp:RadioButtonList> </form> </body> </html>
本例展示了一个带有已选 ListItem 的 RadioButtonList 控件。