ASP.NET ListItem 控件
定義和用法
ListItem 控件可創建列表中的一個項目。
此控件與以下列表控件一同使用: <asp:ListBox> 、 <asp:RadioButtonList>和<asp:BulletedList> 。
語法
<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="label"
Value="value" />
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服務器控件