定義和用法,語法,實例,
定義和用法
ListItem 控制項可創建列表中的一個項目。
此控制項與這些列表控制項一同使用：ASP.NETListBox 控制項 、ASP.NETRadioButtonList 控制項以及ASP.NETBulletedList 控制項。ListItem Web控制項並不是一個獨立存在的控制項，它必須依附在下列幾種 Web控制項下：RadioButtonList Web控制項、DropDownList Web控制項以及CheckBoxList控制項。一個ListItem Web控制項代表的是一個 ListControl Web 控制項的選項內容，也因為如此所以可以不需要指定 Id屬性。
語法<asp:ListItemEnabled="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”文本 |
未設定 | 已設定 | 已設定 | 文本屬性 | 值屬性 |
未設定 | 已設定 | 未設定 | 文本屬性 | 文本屬性 |
未設定 | 未設定 | 已設定 | 值屬性 | 值屬性 |
未設定 | 未設定 | 未設定 | 未設定 | 未設定 |
提示和注釋
注釋：由於 Text 和 Value 屬性都具有空字元串默認值，所以列表控制項中可能有空列表項。
語法
<ASP:ItemList
Id="控制項名稱"
Runat="Server"
Selected="True | False"
Text="選項文字"
Value="控制項標記"
/>
或
<ASP:ItemList
Id="控制項名稱"
Runat="Server"
Selected="True | False"
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>
<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>
