ASP.NET ListItem 控件


up.gif Web 服務(wù)器控件

定義和用法

ListItem 控件可創(chuàng)建列表中的一個(gè)項(xiàng)目。

此控件與以下列表控件一同使用:<asp:ListBox>、 <asp:RadioButtonList> 和 <asp:BulletedList>。


語法

<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="label"
Value="value" />

屬性

屬性描述.NET
Attributes可選的。此類不直接支持的 ListItem 的屬性名和值對的集合。1.0
Enabled可選的。規(guī)定是否禁用或啟用項(xiàng)目。2.0
Selected可選的。規(guī)定是否選定該項(xiàng)。1.0
Text可選的。在 ListItem 中顯示的文本。1.0
Value可選的。ListItem 的值。1.0

Web 控件標(biāo)準(zhǔn)屬性

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

如需完整描述,請?jiān)L問 Web 控件標(biāo)準(zhǔn)屬性。

控件標(biāo)準(zhǔn)屬性

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

如需完整描述,請?jiān)L問 控件標(biāo)準(zhǔn)屬性。

有可能使用 Text 或 Value 屬性以及 inner HTML 文本來設(shè)置顯示列表項(xiàng)的文本。

實(shí)例

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

根據(jù) Text 或 Value 屬性以及 inner HTML 文本的組合,可顯示不同的文本,并可使用不同的值。下面的表格列出了所有可能的組合以及它們的結(jié)果:

Inner HTMLText 屬性Value 屬性顯示的文本使用的值
已設(shè)置已設(shè)置已設(shè)置Inner HTMLValue 屬性
已設(shè)置已設(shè)置未設(shè)置Inner HTMLInner HTML
已設(shè)置未設(shè)置已設(shè)置Inner HTMLValue 屬性
已設(shè)置未設(shè)置未設(shè)置Inner HTMLInner HTML
未設(shè)置已設(shè)置已設(shè)置Text 屬性Value 屬性
未設(shè)置已設(shè)置未設(shè)置Text 屬性Text 屬性
未設(shè)置未設(shè)置已設(shè)置Value 屬性Value 屬性
未設(shè)置未設(shè)置未設(shè)置未設(shè)置未設(shè)置


提示和注釋

注釋:由于 Text 和 Value 屬性都具有空字符串默認(rèn)值,所以列表控件中可能有空列表項(xiàng)。


實(shí)例

帶有基本 ListItem 的 BulletedList
本例展示了 .aspx 文件中帶有兩個(gè) ListItem 的 BulletedList 控件。

帶有不同屬性的 ListItem 的 ListBox
本例展示了 .aspx 文件中帶有幾個(gè) ListItem 的 ListBox 控件。列表中的項(xiàng)目使用了不同的屬性來顯示 ListItem 的文本。

帶有被禁用的 ListItem 的 ListBox
本例展示了一個(gè)帶有被禁用的 ListItem 的 ListBox 控件。

帶有已選的 ListItem 的 RadioButtonList
本例展示了一個(gè)帶有已選 ListItem 的 RadioButtonList 控件。


up.gif Web 服務(wù)器控件