程式師世界 >> 編程語言 >> .NET網頁編程 >> ASP.NET >> 關於ASP.NET >> Web服務器控件：ListItem控件

Web服務器控件：ListItem控件

編輯：關於ASP.NET

閱讀此文請先查看：ASP.NET入門教程:Web服務器控件，簡單講述了Web服務器控件的使用方法。

定義和用法

ListItem 控件可創建列表中的一個項目。

此控件與這些列表控件一同使用：ASP.NET ListBox 控件、ASP.NET RadioButtonList 控件以及ASP.NET BulletedList 控件。ListItem Web控件並不是一個獨立存在的控件，它必須依附在下列幾種 Web控件下：RadioButtonList Web控件、DropDownList Web控件以及CheckBoxList控件。一個ListItem Web控件代表的是一個 ListControl Web 控件的選項內容，也因為如此所以可以不需要指定 Id屬性。

語法

<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

ListControl 標准屬性

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

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

Web 控件標准屬性

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 文本來設置顯示列表項的文本。來源於webjxCom

例子

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

根據 Text 或 Value 屬性以及 inner HTML 文本的組合，可顯示不同的文本，並可使用不同的值。下面的表格列出了所有可能的組合以及它們的值：

內部 HTML 內容文本屬性值屬性呈現的“內部 HTML”內容呈現的“值”屬性已設置已設置已設置內部 HTML 內容值屬性已設置已設置未設置內部 HTML 內容內部 HTML 內容已設置未設置已設置內部 HTML 內容值屬性已設置未設置未設置內部 HTML 內容 “內部 HTML”文本未設置已設置已設置文本屬性值屬性未設置已設置未設置文本屬性文本屬性未設置未設置已設置值屬性值屬性未設置未設置未設置未設置未設置

提示和注釋

注釋：由於 Text 和 Value 屬性都具有空字符串默認值，所以列表控件中可能有空列表項。

語法

<ASP:ItemList
Id="控件名稱"
Runat="Server"
Selected="True | False"
Text="選項文字"
Value="控件標記"
/>
或
<ASP:ItemList
Id="控件名稱"
Runat="Server"
Selected="True | False"
Value="控件標記"
>
選項文字
</ASP:ItemList>

實例

<% Page Language=C#>
<Html>
<Form Id="Form1" Runat="Server">
<ASP:RadioButtonList Id="rblA" Runat="Server">
<ASP:ListItem Text="烤鴨" Selected="True" Value=" Duck "/>
<ASP:ListItem Text="烤雞" Value="Chicken"/>
</ASP:RadioButtonList>
<ASP:Button Id="Button1" Runat="Server" Text='確定' OnClick="Button1_Click"/>
</Form>
<ASP:Label Id="Label1" Runat="Server"/>
<Script Runat="Server">
void Button1_Click(Object Sender, EventArgs e) {
Label1.Text="您選擇了 " + rblA.SelectedItem.Text + " ,它的代號為 " + rblA.SelectedItem.Value；
}
</Script>
</Html>